Tuya MCP SDK

涂鸦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. 设置涂鸦开发者平台

1. 参观 涂鸦开发者平台
2. 导航至 MCP管理 → 定制MCP服务
3. 创建一个新的MCP服务，并记下您的凭据
4. 遵循详细说明 安装说明

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-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

🛠️ 示例

• Golang SDK 示例
• Python SDK 示例

📜 许可证

此项目采用Apache License 2.0授权——详见 许可证 详情见文件。

🆘 支持

• 📚 书籍 文档查看我们的 文档 用于详细指南
• 🐛 蝉（或蚜虫等，具体根据上下文确定） 错误报告: 打开一个问题（或议题）
• 💬 问题： 涂鸦开发者社区
• 🏢 翻译为中文是“公司/企业/办公楼”。这个符号通常用来代表公司、企业或办公场所。 企业联系 涂鸦技术支持