tinysa-mcp

产品定位

tinySA_mcp 是一个用于通过串口操作 TinySA 设备的 MCP 服务器，提供工具化接口以方便设备控制和数据获取。

核心功能

• 发送命令并获取设备响应。
• 获取固件和硬件版本信息。
• 提供 MCP 工具以便与其他系统集成。
• 支持从设备屏幕捕获图像，并可选择带时间戳保存文件。

适用场景

• 需要远程或自动化控制 TinySA 设备的场景。
• 需要获取设备版本信息或详细信息的场景。
• 需要捕获设备屏幕图像并保存的场景。

MCP 工具列表

• get_version: 获取 TinySA 设备的版本信息。
• execute_command: 向 TinySA 设备发送命令并获取响应。
• connect: 连接到指定端口的 TinySA 设备。
• disconnect: 断开 TinySA 设备的连接。
• get_device_info: 获取已连接设备的详细信息。
• capture_image: 捕获 TinySA 屏幕图像，并可选择带时间戳保存到文件。

常见问题解答

• 连接问题: 确保指定的串口正确，并且用户具有适当的权限。
• 命令失败: 检查 MCP 服务器日志（如果可用）以获取错误消息。
• 图像捕获: 验证设备在图像捕获期间是否返回足够的数据（307200 字节）。

使用教程

使用依赖

安装以下 Python 库：

pip install pyserial httpx numpy Pillow FastMCP

安装教程

1. 克隆项目仓库。
2. 安装依赖库（如上所述）。
3. 运行 MCP 服务器。

调试方式

使用以下命令调用 MCP 工具进行调试，例如获取设备版本：

mcp call get_version --args '{"port": "COM4"}'

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。