Rongcloud Server Mcp Python

Ronngcloud MCP 服务

---

🌐 中文版 README

---

📌 项目概述

rongcloud-server-mcp-python 是一个基于 FastMCP 框架构建的 MCP 服务，集成了融云即时通信服务。它支持用户管理、消息发送、群组操作等功能。

---

✨ 工具

工具	描述
register_user	通过融云注册新用户，并返回用户令牌
get_user_info	使用融云获取用户信息
send_private_text_message	发送私聊消息，并返回按每个接收者用户 ID 映射的生成消息 ID
send_group_text_message	发送群组消息，并返回按每个目标群组 ID 映射的生成消息 ID
get_private_messages	获取指定时间范围内两个用户之间的历史私聊消息
create_group	在融云创建包含指定成员的新群聊
dismiss_group	从融云永久删除群聊
get_group_members	获取融云中现有群聊的完整成员列表
join_group	通过融云将一个或多个用户添加到指定群聊
quit_group	将一个或多个用户移出融云群聊
get_current_time_millis	获取自 Unix 纪元（1970 年 1 月 1 日 UTC）以来的当前时间（毫秒）。

---

⚙️ 配置

🔧 环境变量

变量名称	必填	默认值	描述
RONGCLOUD_APP_KEY	✅ 是	-	融云应用 App Key
RONGCLOUD_APP_SECRET	✅ 是	-	融云应用 App Secret
RONGCLOUD_API_BASE	❌ 否	https://api-cn.ronghub.com	融云 API 基础 URL
RONGCLOUD_API_TIMEOUT	❌ 否	10	API 请求超时时间（秒）
FASTMCP_LOG_LEVEL	❌ 否	WARNING	日志级别（例如，DEBUG、INFO）

🧪 配置示例

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 配置

• 配置文件路径：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%/Claude/claude_desktop_config.json

• 配置示例：

{
  "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"
      }
    }
  }
}

---

🧑‍💻 开发指南

🚀 快速开始

1. 克隆代码仓库并进入项目目录：

   git clone https://github.com/your-username/rcloud-server-mcp-python.git
   cd rcloud-server-mcp-python
   

2. 复制环境变量示例文件并编辑变量：

   cp .env.example .env
   

   编辑 .env 文件以设置：

   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. 创建虚拟环境、安装依赖并启动开发服务：

   make venv
   make sync
   make install
   make dev
   

💡 运行 make help 查看所有可用命令。

---

✅ 运行测试

make test     # Run all tests
make lint     # Check code style and quality
make fix      # Auto-fix formatting issues

---

🤝 贡献指南

欢迎贡献！请按照以下步骤操作：

1. Fork 代码仓库
2. 创建功能分支：git checkout -b feature/YourFeature
3. 提交更改：git commit -m 'Add YourFeature'
4. 推送分支：git push origin feature/YourFeature
5. 创建 Pull Request

提交前请确保：

• make lint 不报错
• make test 中的所有测试均通过
• 使用 make format 正确格式化代码

---

📄 许可证

本项目采用 MIT License 许可。