Rongcloud Server Mcp Python
About
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.
Details
- Author
- rongcloud
- Downloads
- 335
- Categories
- Communication
Jump to
- Register users and retrieve user tokens.
- Send private and group text messages.
- Retrieve historical private messages within a time range.
- Create, dismiss, and manage group chats.
- Add or remove users from groups.
- Get current time in milliseconds for debugging.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Rongcloud Server Mcp PythonCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and run the server using uvx with the package name rongcloud-server-mcp-python. Configuration is done via environment variables: RONGCLOUD_APP_KEY and RONGCLOUD_APP_SECRET are required; optionally set RONGCLOUD_API_BASE, RONGCLOUD_API_TIMEOUT, and FASTMCP_LOG_LEVEL. For Claude Desktop, add the MCP server entry in claude_desktop_config.json. Alternatively, clone the repository, set up a virtual environment, and run make dev for local development.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"rongcloud server mcp python": {
"rcloud-server-mcp-python": {
"command": "uvx",
"args": [
"rongcloud-server-mcp-python"
],
"env": {
"RONGCLOUD_APP_KEY": "XXX",
"RONGCLOUD_APP_SECRET": "XXX",
"RONGCLOUD_API_BASE": "https://api.rong-api.com"
}
}
}
}
}McpServers
{
"rcloud-server-mcp-python": {
"command": "uvx",
"args": [
"rongcloud-server-mcp-python"
],
"env": {
"RONGCLOUD_APP_KEY": "XXX",
"RONGCLOUD_APP_SECRET": "XXX",
"RONGCLOUD_API_BASE": "https://api.rong-api.com"
}
}
}Rcloud MCP Server
---
---
📌 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.
---
✨ Tools
| Tool | Description |
|------------------------------|-----------------------------------------------------------------------------|
| register_user | Register a new user via RongCloud and return the user's token |
| get_user_info | Retrieve user information using RongCloud |
| send_private_text_message | Sends private messages and returns generated message IDs mapped to each recipient user ID |
| send_group_text_message | Sends group messages and returns generated message IDs mapped to each target group ID |
| get_private_messages | Retrieves historical private messages between two users within a specified time range |
| create_group | Creates a new group chat in RongCloud with specified members |
| dismiss_group | Permanently deletes a group chat from RongCloud |
| get_group_members | Retrieves the complete member list of an existing group chat in RongCloud |
| join_group | Adds one or more users to a specified group chat via RongCloud |
| quit_group | Removes one or more users from a RongCloud group chat |
| get_current_time_millis | Get the current time in milliseconds since Unix epoch (January 1, 1970 UTC). |
---
⚙️ Configuration
🔧 Environment Variables
| Variable Name | Required | Default | Description |
|---------------------------|----------|------------------------------|------------------------------|
| RONGCLOUD_APP_KEY | ✅ Yes | - | RongCloud Application App Key |
| RONGCLOUD_APP_SECRET | ✅ Yes | - | RongCloud Application App Secret |
| RONGCLOUD_API_BASE | ❌ No | https://api-cn.ronghub.com | RongCloud API base URL |
| RONGCLOUD_API_TIMEOUT | ❌ No | 10 | API request timeout (seconds)|
| FASTMCP_LOG_LEVEL | ❌ No | WARNING | 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.json
Windows:
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
1. Clone the repository and enter the project directory:
git clone https://github.com/your-username/rcloud-server-mcp-python.git
cd rcloud-server-mcp-python
2. Copy example environment file and edit variables:
cp .env.example .env
Edit
.env file 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=INFO
3. Create virtual environment, install dependencies, and start development server:
make venv
make sync
make install
make dev
> 💡 Run
make help to 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:
1. Fork the repository
2. Create a feature branch:
git checkout -b feature/YourFeature
3. Commit your changes:
4. Push the branch:
5. Open a Pull Request
> Please ensure the following before submitting:
>
> No errors with
> All tests pass with
> * Code is properly formatted with ---
📄 License
This project is licensed under the MIT License.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
