使用说明
涂鸦MCP SDK
一个全面的软件开发工具包（SDK），使开发者能够通过标准化的模型上下文协议（MCP）将自定义功能与涂鸦智能云集成，确保无缝连接和互操作性。
✨ 特点/功能
- 🔌（插头/插座） 轻松集成用于连接涂鸦开发者平台到MCP服务器的简易SDK
- 🐍（蛇） 多语言支持提供Python和Go语言版本
- 🔒（锁形图标，通常表示安全、保密或锁定状态） 安全认证与涂鸦云实现的强健认证
- 📱 实时通信基于WebSocket的实时交互
- 🎯 目标 准备就绪，可投入生产全面的错误处理和重试机制
🏗️ 建筑学
涂鸦MCP SDK通过实现模型上下文协议（Model Context Protocol）标准，搭建了自定义MCP服务器与涂鸦开发者平台之间的桥梁
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Your App │───▶│ MCP SDK │───▶│ MCP Gateway │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ MCP Server │
└──────────────────┘
🚀 快速入门
先决条件
- 涂鸦开发者账户 已启用MCP服务
- Python 版本 >= 3.10 且 pip 版本 >= 21.3，或者 Go 版本 >= 1.24
- 访问凭据（访问ID、访问密钥、终端节点）
1. 设置涂鸦开发者平台
2. 选择您的SDK
🐍 Python SDK 示例
# Clone the repository
git clone https://github.com/tuya/tuya-mcp-sdk.git
cd tuya-mcp-sdk/mcp-python
# Install dependencies
pip install -e .
# Run the example
python examples/quick_start.py
Python SDK 使用方法：
from mcp_sdk import create_mcpsdk
# Initialize SDK
async with create_mcpsdk(
endpoint="your-endpoint",
access_id="your-access-id",
access_secret="your-access-secret",
custom_mcp_server_endpoint="http://localhost:8765/mcp"
) as sdk:
# Your MCP server is now connected to Tuya Cloud!
await sdk.run()
🐹 Go SDK 示例
# Navigate to Go SDK
cd tuya-mcp-sdk/mcp-golang
# Install dependencies
go mod tidy
# Run the example
go run examples/main.go
Go SDK 使用方法：
import "mcp-sdk/pkg/mcpsdk"
// Initialize SDK
mcpsdk, err := sdk.NewMCPSdk(
sdk.WithMCPServerEndpoint("http://localhost:8765/mcp"),
sdk.WithAccessParams("access-id", "access-secret", "endpoint"),
)
if err != nil {
log.Fatal(err)
}
// Start the SDK
err = mcpsdk.Run()
📖 文档
| 资源 | 描述 |
|---|---|
| 📋 设置指南 | Tuya开发者平台完整设置指南 |
| 🐍 Python SDK 文档 | Python SDK 文档和示例 |
| 🐹 Go SDK 文档 | Go SDK 文档和示例 |
| 🏗️ 建筑学 | 系统架构图 |
📁 项目结构
tuya-mcp-sdk/
├── 📄 README.md # This file
├── 📄 License # Apache 2.0 License
├── 📁 docs/ # Documentation
│ ├── instructions.md # Setup instructions
│ └── architecture_diagram/ # Architecture diagrams
├── 📁 mcp-python/ # Python SDK
│ ├── src/mcp_sdk/ # Core SDK modules
│ ├── examples/ # Python examples
│ └── README.md # Python-specific docs
└── 📁 mcp-golang/ # Go SDK
├── pkg/ # Go packages
├── examples/ # Go examples
└── README.md # Go-specific docs
🛠️ 示例
📜 许可证
此项目采用Apache License 2.0授权——详见 许可证 详情见文件。
🆘 支持
- 📚 书籍 文档查看我们的 文档 用于详细指南
- 🐛 蝉（或蚜虫等，具体根据上下文确定） 错误报告: 打开一个问题（或议题）
- 💬 问题： 涂鸦开发者社区
- 🏢 翻译为中文是“公司/企业/办公楼”。这个符号通常用来代表公司、企业或办公场所。 企业联系 涂鸦技术支持
