⚙

小度智能终端

将小度智能终端作为Agent，通过MCP协议实现服务化，使AI应用能够无缝地与小度智能终端Agent进行交互。通过本服务，开发者可以轻松实现对小度设备的开放式控制、播报和看护功能，极大地丰富了应用的交互维度，降低了与硬件设备直接通信的复杂性。

混合部署智能终端设备控制

小度智能终端 MCP Server

一个基于 Model Context Protocol (MCP) 的小度智能终端服务，让AI应用能够无缝控制小度设备。支持Claude、Cursor、Cline等所有兼容MCP协议的平台。

✨ 特性

🎯 开放式控制 - 通过自然语言指令控制小度设备
🔊 语音播报 - 让小度设备朗读指定文本
📸 实时拍照 - 获取支持摄像头的小度设备的实时图像
📱 设备管理 - 获取用户绑定的在线设备列表

📋 目录

快速开始
接入方式
工具说明

🚀 快速开始

前提条件

百度开发者账号
小度智能设备
支持MCP的AI工具（Claude、Cursor、Cline等）

获取访问令牌

访问百度开发者平台
按照接入授权文档获取access_token
保存好您的access_token，后续配置时需要使用

🔌 接入方式

我们提供两种接入方式以满足不同场景的需求：

方式一：StreamableHTTP 接入

StreamableHTTP模式直接连接到我们的服务器。

支持的工具

Cherry Studio ✅（推荐，支持请求头配置）
自定义客户端 ✅

配置步骤

以 Cherry Studio 为例：

打开 Cherry Studio → 设置 → MCP服务器
添加新的MCP服务器：

名称: xiaodu_mcp
类型: 可流式传输的HTTP（streamableHttp）
URL: https://xiaodu.baidu.com/dueros_mcp_server/mcp/
请求头: ACCESS_TOKEN=${your_access_token}

启用服务器并开始使用

方式二：Stdio 接入

Stdio模式需要通过本地代理服务连接，这里推荐使用mcp-proxy。

支持的工具

Cursor ✅
Claude Desktop ✅
Cline ✅
其他支持MCP的工具 ✅

配置步骤

第一步：安装代理服务

使用开源项目 mcp-proxy：

BASH``` 1 2 3 4 5 6# 方式1：使用uv安装（推荐） uv tool install mcp-proxy

方式2：使用pipx安装

pipx install mcp-proxy

查看安装路径

which mcp-proxy


**第二步：配置AI工具**


**以 Cursor 为例：**


1. 打开 Cursor → 设置 → MCP
2. 编辑 `mcp.json` 配置文件：


JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15{
  "mcpServers": {
    "xiaodu_mcp": {
      "command": "/Users/.local/bin/mcp-proxy",
      "args": [
        "https://xiaodu.baidu.com/dueros_mcp_server/mcp/",
        "--headers",
        "ACCESS_TOKEN",
        "your_access_token_here",
        "--transport",
        "streamablehttp"
      ]
    }
  }
}

保存配置，重启Cursor
在会话中选择 Agent 模式开始使用

Claude Desktop 配置示例：

编辑 claude_desktop_config.json：

JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15{ “mcpServers”: { “xiaodu_mcp”: { “command”: “/path/to/mcp-proxy”, “args”: [ “https://xiaodu.baidu.com/dueros_mcp_server/mcp/”, “—headers”, “ACCESS_TOKEN”, “your_access_token_here”, “—transport”, “streamablehttp” ] } } }


## 🛠️ 工具说明


本MCP服务器提供以下4个工具，让您能够完全控制小度智能设备：


### 1. 获取设备列表 (`list_user_devices`)


获取与已验证用户关联且当前在线的设备列表。


#### 参数


- 无需参数


#### 返回值


- `List[Dict[str, Any]]`: 设备信息列表



---


### 2. 设备控制 (`control_xiaodu`)


向小度设备发送语音指令，设备将像听到用户说话一样执行该指令。


#### 参数


- `command` (string, required): 要发送给设备的语音指令文本
- `cuid` (string, required): 设备标识符
- `client_id` (string, required): 客户端标识符


#### 返回值


- `string`: 小度设备的响应或执行结果



---


### 3. 语音播报 (`xiaodu_speak`)


让小度设备朗读指定的文本内容。


#### 参数


- `text` (string, required): 要朗读的文本内容
- `cuid` (string, required): 设备标识符
- `client_id` (string, required): 客户端标识符


#### 返回值


- `string`: 操作执行状态



---


### 4. 设备拍照 (`xiaodu_take_photo`)


触发支持摄像头的小度设备进行拍照并返回图像内容。


#### 参数


- `cuid` (string, required): 设备标识符
- `client_id` (string, required): 客户端标识符


#### 返回值


- `ImageContent`: 图像内容对象

- `content` (string): Base64编码的JPEG格式图像数据
- `content_type` (string): 图像内容类型，固定为 “image/jpeg”


## 🧪 测试客户端


为了方便开发者测试MCP服务器功能，我们提供了一个简单的测试客户端：`simple_chatbot`，该客户端支持StreamableHTTP和Stdio两种接入方式。


### 使用方法


1. **配置访问令牌**


编辑 `clients/simple_chatbot/servers_config.json` 文件，将其中的 `Access_Token` 替换为您的访问令牌：


JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13{
    "mcpServers": {
        "xiaodu_mcp_server": {
            "url": "https://xiaodu.baidu.com/dueros_mcp_server/mcp/",
            "transport_type": "streamablehttp",
            "headers": {
                "Access_Token": "your_access_token_here"
            },
            "timeout": 30,
            "sse_read_timeout": 300
        }
    }
}

设置OpenAI API密钥

导出环境变量 LLM_API_KEY，这是您的OpenAI API密钥：

BASH``` 1export LLM_API_KEY=your_openai_api_key_here

3. **运行测试客户端**


进入客户端目录并运行：


BASH```
1
2cd clients/simple_chatbot
python simple_chatbot.py

🙏 致谢

Model Context Protocol - MCP协议标准
mcp-proxy - 优秀的MCP代理工具