Rongcloud Native

You run a Rongcloud-native MCP server that exposes instant messaging capabilities via MCP. It lets you send private and group messages, fetch history, and manage image messages and recalls through a standardized MCP interface. This guide shows practical steps to install, configure, and use the server with MCP clients.

How to use

Configure an MCP client to talk to the Rongcloud native MCP server using the standard stdio workflow. The server runs as a local process and exposes a set of message-related endpoints your client can call, such as sending private/group messages, retrieving history, and recalling messages. Start the server in a dedicated environment, and ensure required environment variables are present before you begin.

How to install

Prerequisites you need before starting the MCP server:

1. Install the UV package manager for Python to run MCP services in isolated environments.

2. Prepare the MCP configuration for your client or deployment tool that will launch the server.

Concrete steps you can follow now:

Step 1 — Install UV

pip install uv

Step 2 — Prepare the MCP server config (stdio)

{
  "mcpServers": {
    "rongcloud_native_mcp": {
      "name": "rongcloud_native_mcp",
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rongcloud-native-mcp-python"
      ],
      "env": {
        "APP_KEY": "融云 App Key",
        "TOKEN": "应用 SDK Token (从 Server API 获取)",
        "AREA_CODE": "数据中心区域码（北京 = 1，新加坡 = 2，北美 = 3，新加坡B = 4，沙特 = 5），非公有云客户不设置",
        "NAVI_URL": "导航地址（非公有云客户）",
        "STATS_URL": "数据统计地址（非公有云客户）"
      }
    }
  }
}

Step 3 — Run the MCP server

Run the server using the configuration you prepared. The command line flow uses UV to fetch and execute the MCP package in an isolated environment. The exact command will be as shown in your config, typically something like the following when launched from your IDE or deployment script.

uvx rongcloud-native-mcp-python

Notes on environment variables

Set the following environment variables to enable the MCP server to authenticate with Rongcloud and route requests correctly.

APP_KEY=your_rongcloud_app_key
TOKEN=your_sdk_token
AREA_CODE=1 # optional for non-public cloud deployments
NAVI_URL=https://navigate.example.com
STATS_URL=https://stats.example.com

Step 4 — Connect with an MCP client

In your MCP client, configure the server endpoint to the local stdio instance you started. The client will invoke tools such as sending text or image messages, recalling messages, and fetching chat history using the provided MCP endpoints.

Configuration examples for Cursor or similar tools

{
  "mcpServers": {
    "rongcloud_native_mcp": {
      "name": "rongcloud_native_mcp",
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rongcloud-native-mcp-python"
      ],
      "env": {
        "APP_KEY": "融云 App Key",
        "TOKEN": "应用 SDK Token (从 Server API 获取)",
        "AREA_CODE": "数据中心区域码（北京 = 1，新加坡 = 2，北美 = 3，新加坡B = 4，沙特 = 5），非公有云客户不设置",
        "NAVI_URL": "导航地址（非公有云客户）",
        "STATS_URL": "数据统计地址（非公有云客户）"
      }
    }
  }
}

Additional sections

Security: Keep APP_KEY and TOKEN confidential. Limit access to the runtime environment running the MCP server. When deploying in production, use secure storage for credentials and rotate tokens regularly.

Troubleshooting

If the server node fails to start, verify that UV and its required runtime are installed. Check that APP_KEY and TOKEN are correctly set and that AREA_CODE is not configured for non-public cloud deployments. Restart the server and retry the tool invocations.

Tools exposed by the server

The server exposes a set of messaging tools you can call through MCP. See the list below for available endpoints and their usage. These tools initialize the IM engine on first use and clean up resources if the connection is lost.

Appendix — Tools overview

• send_private_text_message: Send a private text message to a user
• send_group_text_message: Send a text message to a group
• get_private_messages: Retrieve private chat history with a user
• get_group_messages: Retrieve group chat history
• send_private_image_message: Send a private image message
• send_group_image_message: Send a group image message
• recall_message: Recall a previously sent message Each tool accepts parameters as described in the source and returns a success structure with a code and message or a failure structure with a code and error.

Common questions

Q: Why does the server show a yellow dot in the server list? A: Install UV first, restart the client, and enable the server again.

Q: Why does Cherry Studio report an error? A: Ensure UV and Bun are installed, then restart Cherry Studio and re-enable the service.

Q: Why do tool calls return errors? A: Confirm environment variables (APP_KEY, TOKEN, NAVI_URL) are set correctly and restart the server before retrying.

Available tools

send_private_text_message

Send a private text message to a specific user. Returns a dict with code, message_id, and message on success or code and error on failure.

send_group_text_message

Send a text message to a specific group. Returns a dict with code, message_id, and message on success or code and error on failure.

get_private_messages

Fetch historical private messages with a user. Returns a dict with code and an array of messages on success or code and error on failure.

get_group_messages

Fetch historical messages from a group. Returns a dict with code and an array of messages on success or code and error on failure.

send_private_image_message

Send an image message to a user. Returns a dict with code, message_id, and message on success or code and error on failure.

send_group_image_message

Send an image message to a group. Returns a dict with code, message_id, and message on success or code and error on failure.

recall_message

Recall a previously sent message given the full message object. Returns a dict with code and message on success or code and error on failure.