[Tuya Logo]
Tuya 自定义 MCP 服务器开发指南
文档版本: 20250814
目录
1. 自定义 MCP 服务器
本文档将指导您如何创建、配置自定义 MCP 服务器，并在智能体（Intelligent Agent）中完成其调试。
2. 创建自定义 MCP 服务器
创建自定义 MCP 服务器的步骤如下：
- 登录 Tuya 开发者平台。
- 导航至 “MCP 管理” > “自定义 MCP 服务” 页面，然后点击 “添加自定义 MCP” 按钮。
[截图描述] 页面显示 Tuya 开发者平台界面，左侧导航栏包含“概况”、“AI 产品”、“App”、“云开发”、“智能体”、“数据”、“运营”、“采购”、“增值”等选项。中间区域显示“MCP 管理”部分，包含“官方 MCP 服务”和“自定义 MCP 服务”。“自定义 MCP 服务”下方显示“暂无自定义 MCP 服务”，并有一个醒目的“+ 添加自定义 MCP”按钮。
- 在弹出的 “注册 MCP Server” 窗口中，填写以下信息：
- 服务名称 (中文)
- 服务描述 (中文)
- 服务名称 (英文)
- 服务描述 (英文)
- Icon (图片格式: jpg, jpeg, png; 大小: ≤3MB)
[截图描述] “注册 MCP Server” 弹窗界面。包含输入框用于“服务名称(中文)”、“服务描述(中文)”、“服务名称(英文)”、“服务描述(英文)”。下方有一个“Icon”区域，显示一个“M”字母的占位符图片，并说明了支持的图片格式和大小限制。弹窗底部有“取消”和“确定”按钮。
3. 配置自定义 MCP 服务
MCP 服务器创建完成后，系统会自动跳转到其服务详情页面。
- 在 “服务接入配置管理” > “数据中心” 部分，点击右侧的 “添加数据中心” 按钮，并根据您的实际需求选择一个数据中心（例如：中国数据中心、美西数据中心、中欧数据中心等）。
[截图描述] 页面显示服务详情，左侧导航栏包含“服务介绍”、“服务接入配置管理”、“数据中心”等。在“数据中心”部分，有一个“添加数据中心”按钮。点击后，会弹出一个列表，包含“中国数据中心”、“美西数据中心”、“中欧数据中心”、“美东数据中心”、“印度数据中心-暂不支持”、“西欧数据中心-暂不支持”、“新加坡数据中心”。
- 在选定的数据中心下方，您将看到 “接入地址 (Access URL)”、“Access ID” 和 “Access secret”。请复制并粘贴这些信息到本地保存。这些参数将在后续使用 MCP 的 SDK 时用到。
[截图描述] “数据中心”部分显示已选中的“中国数据中心”，其状态为“离线”。下方显示“接入地址: https://mcp.tuyacn.com”、“Access ID: de7d”、“Access secret: a8f1”。
[提示] 具体参考信息请查阅 Github 源码中的 README 说明。
4. 基于 SDK 访问 MCP 服务器
请前往 Github 下载 MCP 的 SDK 并阅读相关资料。
[截图描述] Github 页面显示 “tuya / tuya-mcp-sdk” 仓库。页面顶部有仓库名称、描述、代码、Issues、Pull requests 等导航。仓库主页显示了文件列表，包括 `docs` 目录、`mcp-golang`、`mcp-python`、`.gitignore`、`License`、`README-zh.md`、`README.md` 等文件。右侧“About”区域提供了仓库的简要描述：“A comprehensive SDK that empowers developers to integrate their custom capabilities with Tuya Cloud through the standardized Model Context Protocol (MCP), ensuring seamless connectivity and interoperability.” 仓库信息显示有 2 个 commits，2 stars，0 watching，1 fork。
5. 运行并调试 MCP 服务器
为了确保您的自定义 MCP 服务器能够正常运行，需要在智能体中进行运行和调试。
5.1. 运行并调试
- 首先，在已选定的数据中心下，检查 MCP 服务器的服务状态。
[截图描述] Tuya 开发者平台界面，显示“我的MCPServer”服务详情。在“数据中心”部分，显示“中国数据中心 服务状态: 在线”。
- 接着，在 “工具” 页面，查看您的 MCP 服务器可用的工具列表。
[截图描述] Tuya 开发者平台界面，显示“我的MCPServer”服务详情下的“工具”页面。列出了“可用工具 4”项，包括：
play_music、stop_music、take_photo、view_photo。 - 接下来，在您想要测试的工具下方，点击 “试运行” 按钮。
[截图描述] “试运行”窗口打开，显示了 `play_music` 工具的输入参数 “music_name (String)”，并提供了一个示例值 “classic”。下方有“Music name, if not provided, will play the default music”的描述。右侧是“Request”和“Response”区域，显示 JSON 格式的请求体：
{"music_name": "classic"}。 - 在 “试运行” 窗口中，点击 “运行” 按钮。当左下角显示 “调试通过” 时，表示 MCP 工具调试成功。
[截图描述] “试运行”窗口中，点击“运行”按钮后，左下角显示绿色的“调试通过”状态指示符。
5.2. 在智能体中添加 MCP 服务器
- 前往 “我的智能体” 页面，点击 “开发版本” 进入智能体的开发页面。
[截图描述] Tuya 开发者平台界面，显示“我的智能体”页面，其中有一个名为“buding”的智能体，并显示“开发版本”。
- 在 “01 模型能力配置” > “技能配置” 下，选择 “MCP 服务”，然后点击右侧的添加 (+) 按钮。
[截图描述] 智能体配置页面，左侧为“01 模型能力配置”，右侧为“02 提示词开发”。在“01 模型能力配置”下，有“模型设置”和“技能配置”。在“技能配置”下，列出了“工具集”、“MCP 服务”、“工作流”等，其中“MCP 服务”旁边有一个添加 (+) 按钮。
- 在弹出的 “添加 MCP 服务” 窗口中，选择 “自定义 MCP 服务”，然后按需将您创建的 MCP 服务器添加到智能体中。
[截图描述] “添加 MCP 服务”窗口显示。顶部有“官方 MCP 服务”和“自定义 MCP 服务”选项卡。在“自定义 MCP 服务”下，列出了之前创建的“我的MCPServer”。每个工具（play_music, stop_music, take_photo, view_photo）旁边都有一个“添加”按钮。
至此，您已成功完成了自定义 MCP 服务器的开发及调试过程。
