关于 HardwareMCP
HardwareMCP 是远程 MCP 服务,帮助 AI Agent 查找实体硬件对应的 MCP 服务。其目录提供服务详情、安装命令和客户端配置,涵盖 ESP32、3D 打印机和摄像头等设备。
主要功能
- 01搜索硬件服务目录
- 02获取服务需求和设置信息
- 03列出设备类别及服务数量
- 04按设备和目标推荐服务
适用场景
- 01为指定的 3D 打印机查找 MCP 服务
- 02查找 ESP32 或 Raspberry Pi 项目的服务选项
- 03获取硬件服务的安装命令和客户端配置
MCP 相关
HardwareMCP 向 MCP 客户端提供目录搜索、服务详情、设备列表和推荐工具。可通过托管的 Streamable HTTP 端点使用,也可在本地通过 stdio 运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://hardwaremcp.khanex.ai/mcpclaude mcp add --transport http saadvz-hardwaremcp https://hardwaremcp.khanex.ai/mcp{"mcpServers":{"saadvz-hardwaremcp":{"type":"http","url":"https://hardwaremcp.khanex.ai/mcp"}}}在 Cursor 中打开{"servers":{"saadvz-hardwaremcp":{"type":"http","url":"https://hardwaremcp.khanex.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"saadvz-hardwaremcp":{"type":"http","url":"https://hardwaremcp.khanex.ai/mcp"}}}{"mcpServers":{"saadvz-hardwaremcp":{"serverUrl":"https://hardwaremcp.khanex.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 自由文本搜索,例如 'bambu'、'flash firmware'、'frigate'。使用 '' 并配合设备/类别筛选条件可列出全部结果。 |
| device | string | 否 | 设备筛选条件,例如 'esp32'、'Bambu X1C'、'Home Assistant' |
| category | enum | 否 | smart-home | microcontrollers | 3d-printers | cameras | robots | dev-tools | lab-gear |
详细介绍
hardwaremcp
远程端点: https://hardwaremcp.khanex.ai/mcp。将它粘贴到任意 MCP 客户端中即可使用:无需安装,也无需 API 密钥。
询问你的 Agent “我的 Bambu P1S 应该使用哪个 MCP 服务?”,它就会从 HardwareMCP 目录中找到合适的服务、安装命令和客户端配置。
一个帮助 AI Agent 查找实体硬件对应的 MCP 服务的 MCP 服务:ESP32、Arduino、Raspberry Pi、RP2040、3D 打印机(Bambu、Prusa、Klipper、OctoPrint)、Home Assistant、摄像头(Frigate、UniFi Protect、ONVIF)、Zigbee、串口/BLE 和实验室设备。
它是 HardwareMCP 目录之上的轻量封装:包含 59 个服务,其安装命令和客户端配置摘自各自的 README。
工具
| 工具 | 功能 |
|---|---|
search_servers(query, device?, category?) | 搜索目录。结果按 GitHub 星标数排序。 |
get_server(slug) | 完整详情:功能、要求、安装命令和客户端配置片段。 |
list_devices() | 列出每个设备系列及其服务数量。 |
recommend_for_device(device, goal?) | 为设备或型号(例如“Bambu P1S”“Voron”“ESP32-S3”)推荐优选项,也可按目标排序。 |
使用托管服务(无需安装)
端点:https://hardwaremcp.khanex.ai/mcp(Streamable HTTP、无状态、无需身份验证、开放 CORS、返回 JSON 响应)。POST 处理 JSON-RPC,OPTIONS 返回带有 CORS 标头的 204;由于没有会话或由服务端发起的数据流,GET/DELETE 会返回 405。
Claude Code
claude mcp add --transport http hardwaremcp https://hardwaremcp.khanex.ai/mcp
Cursor(~/.cursor/mcp.json)
{ "mcpServers": { "hardwaremcp": { "url": "https://hardwaremcp.khanex.ai/mcp" } } }
Claude Desktop(claude_desktop_config.json)
{ "mcpServers": { "hardwaremcp": { "command": "npx", "args": ["-y", "mcp-remote", "https://hardwaremcp.khanex.ai/mcp"] } } }
Grok Bot(桌面应用):没有用于填写 MCP URL 的设置项。在 Bot 聊天中发送:
Add a custom MCP server named hardwaremcp at https://hardwaremcp.khanex.ai/mcp
出现确认提示时确认即可(无需登录),然后输入 @ 并选择 hardwaremcp。(Cursor 论坛答复)
Muse(Meta):在聊天中让 Muse 创建一个自定义连接器(Meta 帮助中心):
Create a Custom Connector for a new remote MCP server, then connect to it:
- Name: hardwaremcp
- Transport: remote streamable HTTP
- URL: https://hardwaremcp.khanex.ai/mcp
- Auth: none (public, no API key or OAuth)
Then list its tools and call list_devices to confirm it works.
本地运行(stdio)
npx -y hardwaremcp # once published to npm
{ "mcpServers": { "hardwaremcp": { "command": "npx", "args": ["-y", "hardwaremcp"] } } }
开发
npm install
npm run gen-data # regenerate src/data.ts from ../hardwaremcp/data/servers.json
npm run build
npm test # scripted client over stdio
node test-client.mjs https://hardwaremcp.khanex.ai/mcp # against the live endpoint
注意事项
安装命令摘自各项目的 README,且未经 HardwareMCP 实际测试。在允许 Agent 访问硬件前,请先检查代码。
许可证
MIT
收录于
- 收录在官方 MCP Registry中,标识为
io.github.saadvz/hardwaremcp - Glama,通过
glama.json
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。