Rcloud 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.

✨ Tools

⚙️ Configuration

🔧 Environment Variables

🧪 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

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: git commit -m 'Add YourFeature'
4. Push the branch: git push origin feature/YourFeature
5. 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 MIT License.