rongcloud-server-mcp-python by rongcloud - MCP Server

Ronngcloud 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: %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-python

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

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:

Fork the repository
Create a feature branch: git checkout -b feature/YourFeature
Commit your changes: git commit -m 'Add YourFeature'
Push the branch: git push origin feature/YourFeature
Open a Pull Request

Please ensure the following before submitting:

No errors with make lint

All tests pass with make test

Code is properly formatted with make format

📄 License

This project is licensed under the .