RongCloud MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RongCloud MCP Server Register user Alice and get her token."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ronngcloud MCP Server
π δΈζη README
π Project Overview
rongcloud-server-mcp-python is an MCP server built on the FastMCP framework, integrating RongCloud instant messaging services. It supports user management, message sending, group operations, and more.
Related MCP server: lark-mcp
β¨ Tools
Tool | Description |
| Register a new user via RongCloud and return the user's token |
| Retrieve user information using RongCloud |
| Sends private messages and returns generated message IDs mapped to each recipient user ID |
| Sends group messages and returns generated message IDs mapped to each target group ID |
| Retrieves historical private messages between two users within a specified time range |
| Creates a new group chat in RongCloud with specified members |
| Permanently deletes a group chat from RongCloud |
| Retrieves the complete member list of an existing group chat in RongCloud |
| Adds one or more users to a specified group chat via RongCloud |
| Removes one or more users from a RongCloud group chat |
| Get the current time in milliseconds since Unix epoch (January 1, 1970 UTC). |
βοΈ Configuration
π§ Environment Variables
Variable Name | Required | Default | Description |
| β Yes | - | RongCloud Application App Key |
| β Yes | - | RongCloud Application App Secret |
| β No |
| RongCloud API base URL |
| β No |
| API request timeout (seconds) |
| β No |
| Log level (e.g., DEBUG, INFO) |
π§ͺ Example Configuration
RONGCLOUD_APP_KEY=your_app_key
RONGCLOUD_APP_SECRET=your_app_secret
RONGCLOUD_API_BASE=https://api-cn.ronghub.com
RONGCLOUD_API_TIMEOUT=10
FASTMCP_LOG_LEVEL=WARNINGπ» Claude Desktop Configuration
Config file paths:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
Example configuration:
{
"mcpServers": {
"rongcloud-server-mcp": {
"command": "uvx",
"args": [
"rongcloud-server-mcp-python"
],
"env": {
"RONGCLOUD_APP_KEY": "your_app_key",
"RONGCLOUD_APP_SECRET": "your_app_secret",
"RONGCLOUD_API_BASE": "https://api-cn.ronghub.com",
"RONGCLOUD_API_TIMEOUT": "10"
}
}
}
}π§βπ» Development Guide
π Quick Start
Clone the repository and enter the project directory:
git clone https://github.com/your-username/rcloud-server-mcp-python.git cd rcloud-server-mcp-pythonCopy example environment file and edit variables:
cp .env.example .envEdit
.envfile to set:RONGCLOUD_APP_KEY=your_app_key RONGCLOUD_APP_SECRET=your_app_secret RONGCLOUD_API_BASE=https://api-cn.ronghub.com FASTMCP_LOG_LEVEL=INFOCreate virtual environment, install dependencies, and start development server:
make venv make sync make install make dev
π‘ Run
make helpto see all available commands.
β Running Tests
make test # Run all tests
make lint # Check code style and quality
make fix # Auto-fix formatting issuesπ€ Contribution Guide
Contributions are welcome! Please follow these steps:
Fork the repository
Create a feature branch:
git checkout -b feature/YourFeatureCommit your changes:
git commit -m 'Add YourFeature'Push the branch:
git push origin feature/YourFeatureOpen a Pull Request
Please ensure the following before submitting:
No errors with
make lintAll tests pass with
make testCode is properly formatted with
make format
π License
This project is licensed under the MIT License.
Available Tools
11 toolscreate_groupB
Creates a new group chat in RongCloud with specified members.
Inputs: user_ids (required), group_id (required), group_name (required).
dismiss_groupB
Permanently deletes a group chat from RongCloud.
Inputs: user_id (required), group_id (required).
get_current_time_millisA
Get the current time in milliseconds since Unix epoch (January 1, 1970 UTC).
Inputs: no named parameters.
get_group_membersA
Retrieves the complete member list of an existing group chat in RongCloud.
Inputs: group_id (required).
get_private_messagesA
Retrieves historical private messages between two users within a specified time range.The time range is defined by startTime (newest) and endTime (oldest),with endTime must be earlier than startTime.
Inputs: user_id (required), target_id (required), end_time, start_time, +1 more.
get_user_infoC
Retrieve user information using RongCloud.
Inputs: user_id (required).
join_groupB
Adds one or more users to a specified group chat via RongCloud.
Inputs: user_ids (required), group_id (required), group_name.
quit_groupB
Removes one or more users from a RongCloud group chat.
Inputs: user_ids (required), group_id (required).
register_userC
Register a new user via RongCloud and return the user's token.
Inputs: user_id (required), name (required), portrait_uri.
send_group_text_messageB
Send group text messages to one or multiple groups via RongCloud.
Inputs: from_user_id (required), to_group_ids (required), content (required).
send_private_text_messageC
Send private text messages to one or multiple recipients via RongCloud.
Inputs: from_user_id (required), to_user_ids (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 11 tools
Each tool has a distinct purpose: group CRUD, messaging, user management, and a utility function. No two tools perform overlapping actions, and descriptions clearly differentiate them.
Most tools follow a consistent verb_noun pattern (e.g., create_group, send_private_text_message). However, get_current_time_millis breaks the pattern by using an adjective and unit, causing a minor inconsistency.
With 11 tools covering group management, messaging, and user management, the scope is well-calibrated for a chat API. No tool feels superfluous, and the count fits typical MCP server sizes.
Core operations like create/dismiss groups, join/quit, send messages, and retrieve history are covered. However, missing update group, delete user, edit/delete messages, and conversation listing create notable gaps that agents may encounter.
Maintenance
Related MCP Connectors
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Send WhatsApp messages and templates, manage chats, contacts, broadcasts and AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Feishu/Lark platform APIs for automation scenarios including message management, document operations, calendar scheduling, group management, and Bitable operations through natural language.33,913 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Feishu/Lark Open Platform APIs for tasks like document processing, chat management, and calendar scheduling.33,913 npmMIT
- AlicenseBqualityDmaintenanceEnables AI assistants to manage contacts, send messages, handle conversations, and manage workspace via the Respond.io API.28179 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to send and retrieve messages, access employee information, and interact with group chats via the SeaTalk API.111MIT