快速开始
本文档将帮助你快速完成部署与接入配置，开始使用 Server MCP 提供的 IM 服务能力。
准备工作
在开始之前，请确保您已准备就绪：
- 融云账户凭证:
- 客户端环境: 已安装 Cherry Studio 等支持 MCP 协议的客户端。
接入方式
提供两种接入方式，满足本地集成与远程访问需求：
| 模式 | 鉴权方式 | 协议类型 | 部署方式 | 适用说明 |
|---|---|---|---|---|
| STDIO | AppKey + AppSecret | stdio | 本地部署 | 模型本地集成运行 |
| SSE | API Key | SSE 长连接 | 官方托管部署 | 模型远程调用访问 |
STDIO 模式接入
适用场景
- 在同一机器上运行的本地集成和工具
- 安全敏感操作
- 低延迟需求
- 支持二次开发与调试
配置变量
| 变量名 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
RONGCLOUD_APP_KEY | 是 | - | 融云应用的 App Key |
RONGCLOUD_APP_SECRET | 是 | - | 融云应用的 App Secret |
RONGCLOUD_API_BASE | 否 | https://api.rong-api.com | 融云 API 基础 URL |
RONGCLOUD_API_TIMEOUT | 否 | 10 秒 | 接口请求超时时间（单位：秒） |
FASTMCP_LOG_LEVEL | 否 | WARNING | 日志级别（如：DEBUG、INFO、WARNING） |
接入步骤
步骤 1：安装 UV 工具
bash
# macOS / Linux 安装
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows 安装
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 或使用 pip 安装
pip install uv
步骤 2：（仅 macOS）安装 coreutils
bash
brew install coreutils
步骤 3：配置 MCP Server（以 Cherry Studio 为例）
- 打开 CherryStudio 的 MCP 服务器设置页面
- 点击“添加服务器（从 JSON 导入）”
- 填入以下配置信息：
JSON
{
"mcpServers": {
"rongcloud-server-mcp-python": {
"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.rong-api.com"
}
}
}
}
如果提示添加失败，可关闭设置页面后手动保存配置即可生效。
-
打开 Cherry Studio 的模型服务设置页面，选择并启用一个聊天模型，然后在对应位置填写 API 密钥（可在该模型的官网申请）。
-
打开 Cherry Studio 的聊天页面，选择所需的聊天模型，并勾选已配置的 MCP。完成后，输入消息即可开始对话。
SSE 模式接入
适用场景
- 集中式更新，免运维
- 多端共享、轻量接入
接入地址
| 区域 | 接入域名 |
|---|---|
| 国内 | https://ai.rong-api.com |
| 新加坡 | https://ai.sg-light-api.com |
请求格式示例：
https://ai.rong-api.com/mcp/sse?api_key=<YourKey>
参数说明
| 参数名 | 是否必填 | 说明 |
|---|---|---|
api_key | 是 | 融云控制台申请的 API Key |
接入步骤
步骤 1：获取 API Key
前往融云控制台申请或查看对应的 API Key。
步骤 2：配置 MCP Server（以 Cherry Studio 为例）
- 打开 CherryStudio 的 MCP 服务器设置页面
- 点击“添加服务器（从 JSON 导入）”
- 填写以下配置信息：
JSON
{
"mcpServers": {
"rongcloud-server-mcp-sse": {
"type": "sse",
"url": "https://ai.rong-api.com/mcp/sse?api_key=your_api_key"
}
}
}
提示
如果提示添加失败，可关闭设置页面后手动保存配置即可生效。
-
打开 Cherry Studio 的模型服务设置页面，选择并启用一个聊天模型，然后在对应位置填写 API 密钥（可在该模型的官网申请）。
-
打开 Cherry Studio 的聊天页面，选择所需的聊天模型，并勾选已配置的 MCP。完成后，输入消息即可开始对话。
项目仓库地址
- GitHub: rongcloud-server-mcp-python
- Gitee: rongcloud-server-mcp-python