About HardwareMCP
HardwareMCP is a remote MCP server that helps AI agents find MCP servers for physical hardware. Its catalog provides server details, installation commands, and client configuration for devices and systems ranging from ESP32 boards to 3D printers and cameras.
Key features
- 01Search hardware-server catalog
- 02Retrieve server requirements and setup details
- 03List device families and server counts
- 04Recommend servers by device and goal
Use cases
- 01Find an MCP server for a specific 3D printer
- 02Locate server options for ESP32 or Raspberry Pi projects
- 03Get setup commands and client configuration for hardware
MCP support
HardwareMCP exposes catalog search, server details, device listings, and recommendations as tools for MCP clients. It is available as a hosted Streamable HTTP endpoint or can run locally over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
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"}}}Open in Cursor{"servers":{"saadvz-hardwaremcp":{"type":"http","url":"https://hardwaremcp.khanex.ai/mcp"}}}Open in VS Code{"mcpServers":{"saadvz-hardwaremcp":{"type":"http","url":"https://hardwaremcp.khanex.ai/mcp"}}}{"mcpServers":{"saadvz-hardwaremcp":{"serverUrl":"https://hardwaremcp.khanex.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Free-text search, e.g. 'bambu', 'flash firmware', 'frigate'. Use '' with a device/category filter to list all. |
| device | string | No | Device filter, e.g. 'esp32', 'Bambu X1C', 'Home Assistant' |
| category | enum | No | smart-home | microcontrollers | 3d-printers | cameras | robots | dev-tools | lab-gear |
Details
From the project READMEhardwaremcp
Remote endpoint: https://hardwaremcp.khanex.ai/mcp. Paste it into any MCP client: no install, no API key.
Ask your agent "which MCP server should I use for my Bambu P1S?" and it gets the right server, install commands and client config from the HardwareMCP catalog.
An MCP server that helps your AI agent find MCP servers for physical hardware: ESP32, Arduino, Raspberry Pi, RP2040, 3D printers (Bambu, Prusa, Klipper, OctoPrint), Home Assistant, cameras (Frigate, UniFi Protect, ONVIF), Zigbee, serial/BLE and lab gear.
It's a thin layer over the HardwareMCP catalog: 59 servers with install commands and client configs copied from their READMEs.
Tools
| Tool | What it does |
|---|---|
search_servers(query, device?, category?) | Search the catalog. Results sorted by GitHub stars. |
get_server(slug) | Full details: what it does, requirements, install commands, client config snippet. |
list_devices() | Every device family with server counts. |
recommend_for_device(device, goal?) | Top picks for a device or model (e.g. "Bambu P1S", "Voron", "ESP32-S3"), optionally ranked by a goal. |
Use the hosted server (no install)
Endpoint: https://hardwaremcp.khanex.ai/mcp (Streamable HTTP, stateless, no auth, CORS open, JSON responses). POST handles JSON-RPC, OPTIONS returns 204 with CORS headers, and GET/DELETE return 405 because there are no sessions or server-initiated streams.
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 (desktop app): there's no settings field for MCP URLs. In a Bot chat, send:
Add a custom MCP server named hardwaremcp at https://hardwaremcp.khanex.ai/mcp
Confirm when asked (no sign-in needed), then type @ and pick hardwaremcp. (Cursor forum answer)
Muse (Meta): ask Muse in chat to create a Custom Connector (Meta Help Center):
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.
Run locally (stdio)
npx -y hardwaremcp # once published to npm
{ "mcpServers": { "hardwaremcp": { "command": "npx", "args": ["-y", "hardwaremcp"] } } }
Develop
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
Caveat
Install commands come from each project's README and haven't been bench-tested by HardwareMCP. Review code before giving an agent access to your hardware.
License
MIT
Listed in
- Official MCP Registry as
io.github.saadvz/hardwaremcp - Glama, via
glama.json
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.