RingCentral REST API服务端

一个高质量的RingCentral REST API服务端,支持SMS、语音、消息、会议和分析等功能,适用于企业通信和协作场景。

  • by BusyBee3333
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BusyBee3333/ringcentral-mcp-2026-complete

使用说明

mcp服务器环中心

生产质量MCP服务器 中环 REST API-短信、语音、消息、会议和分析。

特性

  • 48工具 跨短信、语音、分机、会议、消息、语音邮件、联系人、呼叫队列、分析和帐户管理
  • 带有严格模式的完整TypeScript——零 any 投射
  • 具有自动刷新功能的自动OAuth2 JWT令牌管理
  • 对每个列表端点进行分页
  • structuredContent 在每个工具响应上
  • readOnlyHint: true 在所有GET/搜索/列表工具上
  • 适用于Claude Desktop、Cursor和任何兼容MCP的客户端

工具清单

模块 工具 计数
sms send_sms、list_sms_message、get_sms_message、delete_sms_messages、list_conversations 5
语音 make_ringout_call、list_call_log、get_call_log_record、list_active_calls、get_call_recording 5
扩展 列表扩展、获取扩展、更新扩展、列表扩展电话号码、获取扩展呈现 5
会议 列表会议、获取会议、创建会议、更新会议、删除会议、获取邀请 6
messages 列表消息、获取消息、删除消息、列表消息附件、获取消息 5
语音邮件 列表_语音邮件,获取_语音邮件
contacts 列表_公司_联系人、获取_联系、创建_联系、更新_联系、删除_联系、搜索_联系 6
call_queues list_call_queues、get_call_queue、list_queue_members、update_queue_settings 4
分析 get_call_log_analytics、get_usage_report、get_performance_report 3
account get_count_info、list_phone_numbers、get_service_info、list _blocked_numbers 4
总计 48

先决条件

  • Node.js 18+
  • RingCentral开发人员帐户
  • A. JWT服务器应用程序 在RingCentral开发者门户上

设置

1.创建JWT应用程序

  1. 首选 https://developers.ringcentral.com
  2. 点击 创建应用程序 → 选择 服务器/机器人应用程序(JWT)
  3. 添加所需权限:
    ReadAccounts, ReadCallLog, RingOut, SMS, ReadMessages, EditMessages, Meetings, Contacts, CallQueues, Analytics
  4. 注意你的 客户端ID 和 客户端密钥
  5. 在...之下 认证 → 创建一个 JWT证书 对于您的用户/服务帐户
  6. 复制JWT值

2.安装和配置

git clone https://github.com/BusyBee3333/ringcentral-mcp-2026-complete.git
cd ringcentral-mcp-2026-complete

npm install

cp .env.example .env
# Edit .env with your credentials

3.建造

npm run build

4.连接到克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ringcentral": {
      "command": "node",
      "args": ["/path/to/ringcentral-mcp-2026-complete/dist/index.js"],
      "env": {
        "RC_CLIENT_ID": "your_client_id",
        "RC_CLIENT_SECRET": "your_client_secret",
        "RC_JWT": "your_jwt"
      }
    }
  }
}

5.连接到光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "ringcentral": {
      "command": "node",
      "args": ["/path/to/ringcentral-mcp-2026-complete/dist/index.js"],
      "env": {
        "RC_CLIENT_ID": "your_client_id",
        "RC_CLIENT_SECRET": "your_client_secret",
        "RC_JWT": "your_jwt"
      }
    }
  }
}

沙箱测试

集 RC_SERVER_URL=https://platform.devtest.ringcentral.com 在你的 .env 以RingCentral沙盒环境为目标。

发展

# Watch mode
npm run dev

# Type-check only
npm run typecheck

API 参考

此服务器包装 RingCentral REST API v1.0.

基本URL: https://platform.ringcentral.com/restapi/v1.0/

许可证

麻省理工学院