@tencentcloud/sdk-mcp
v1.7.8
Published
Tencent Cloud MCP Server for SDK
Readme
腾讯云 SDK MCP Server
腾讯云 SDK MCP Server 通过 MCP(Model Context Protocol)向 AI 助手提供官方文档检索与集成能力,帮助你更快完成腾讯云实时音视频相关开发(Chat/Call/Live/Room/RTCEngine/TIMPush)。
功能概览
- 官方资料检索:快速定位产品文档、集成指引与最佳实践。
- 智能分流:按产品、平台、框架进行语义路由,降低检索噪声。
- 代码集成能力:支持 Web / Android / iOS / Flutter 等主流端侧集成入口。
- MCP 兼容:可接入 Cursor、CodeBuddy、Codex、Claude 等 MCP 客户端。
环境要求
- Node.js >= 18
- npm
- 任一支持 MCP 的 IDE / AI 客户端
30 秒快速开始(免控制台创建应用试用)
1) 配置 MCP Server(试用模式)
以 Cursor 为例,在项目 .cursor/mcp.json(或 ~/.cursor/mcp.json)中添加:
{
"mcpServers": {
"tencentcloud-sdk-mcp": {
"command": "npx",
"args": ["-y", "@tencentcloud/sdk-mcp@latest"],
"env": {
"SDKAPPID": "",
"SECRETKEY": ""
}
}
}
}2) 确认服务已连接
在 MCP 面板确认 tencentcloud-sdk-mcp 状态为 Connected。
3) 用前缀显式激活工具
建议在问题前加 @tencentcloud-sdk-mcp,提升工具命中率与回答稳定性。
示例:
@tencentcloud-sdk-mcp H5 集成 Web IM SDK 怎么发送语音消息?完整配置(需要在控制台创建应用)
{
"mcpServers": {
"tencentcloud-sdk-mcp": {
"command": "npx",
"args": ["-y", "@tencentcloud/sdk-mcp@latest"],
"env": {
"SDKAPPID": "YOUR_SDKAPPID",
"SECRETKEY": "YOUR_SECRET_KEY"
}
}
}
}控制台入口:
- 即时通信 IM 控制台:
https://console.cloud.tencent.com/im - 音视频 TRTC 控制台:
https://console.cloud.tencent.com/trtc
接入准备说明
- 无账号/未创建应用也可先试用:可先体验文档检索与知识咨询能力。
SDKAPPID:你的 IM/TRTC 应用 ID(控制台获取)。SECRETKEY:用于测试生成userSig。- 生产环境要求:
userSig必须由服务端签发,不建议长期使用本地测试签发方式。
常见问题
- 连接失败/工具未激活:检查 MCP 配置是否生效,确认服务状态为 Connected。
npx异常:可清理npx缓存后重试:rm -rf ~/.npm/_npx && npm cache verify。userSig无效:重新调用get_usersig生成。
更新记录
仅展示最近更新,完整历史请查看
CHANGELOG.md。
Version 1.7.8 @2026.09.20
新增
- 新增基于 RRF 的 BM25 + Dense 混合检索能力,提升复杂自然语言查询下的召回与排序稳定性。
- 新增向量索引构建流程:接入
build:vectors,在构建阶段生成/更新向量索引,支持检索链路的语义召回。
变更
- 优化框架前置门控规则:扩展跨平台问法识别,新增英文
callback/server callback信号,降低服务端回调类问题被误判为必须先选框架的概率。 - 增强
preflight-route的 prompt 框架识别能力:补充vue/react显式信号采集,提升 product-only 入口下的框架补全准确性。
修复
- 修复部分 Chat 场景下因框架信号缺失或英文回调问法导致的
needs_framework误触发问题,减少本应可直接召回的请求被前置拦截。
