MCPD

v1.0.0Developer Toolsstable

MCP Server SDK for Microcontrollers — Expose ESP32/RP2040 hardware as AI-accessible tools via Model Context Protocol

aiai-agentsclaudecursor-aillm
Share:
10
Stars
0
Downloads
0
Weekly
0/5

What is MCPD?

MCPD is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server sdk for microcontrollers — expose esp32/rp2040 hardware as ai-accessible tools via model context protocol

MCP Server SDK for Microcontrollers — Expose ESP32/RP2040 hardware as AI-accessible tools via Model Context Protocol

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP Server SDK for Microcontrollers — Expose ESP32/RP2040 ha

Use Cases

Expose ESP32/RP2040 hardware as tools
IoT device integration with AI
pouriya

Maintainer

LicenseBSD-3-Clause
Languagerust
Versionv1.0.0
UpdatedFeb 27, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpd

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPD

mcpd (MCP daemon) is a single-binary MCP server written in Rust that turns any executable script into an MCP tool. It scans a directory of scripts, reads their self-describing --help output to extract parameter definitions, and exposes each script as a named tool over HTTP JSON-RPC. It includes a built-in web dashboard, optional authentication, TLS support, and works with Claude Desktop, Cursor, and any MCP-compatible client.

Prerequisites

  • macOS, Linux, or Windows operating system
  • Docker (optional, for the container-based quick start)
  • Executable scripts to expose as tools (shell scripts, Python, etc.)
  • Claude Desktop or another MCP-compatible client
  • curl or wget for downloading the binary
1

Download the mcpd binary

Download the prebuilt single binary for your platform from GitHub Releases and make it executable.

# macOS Apple Silicon
curl -Lo mcpd https://github.com/pouriya/mcpd/releases/latest/download/mcpd-aarch64-apple-darwin
chmod +x mcpd

# Linux x86_64
curl -Lo mcpd https://github.com/pouriya/mcpd/releases/latest/download/mcpd-x86_64-unknown-linux-musl
chmod +x mcpd

# Or use Docker
docker pull ghcr.io/pouriya/mcpd:latest
2

Create a scripts directory with your first tool

Create a directory for your scripts. Each executable file becomes an MCP tool. Scripts must respond to --help with JSON metadata on stdout and parameter definitions on stderr.

mkdir -p ~/mcpd-scripts

cat > ~/mcpd-scripts/date << 'EOF'
#!/bin/sh
if [ "$1" = "--help" ]; then
  echo '{"description": "Get the current date and time"}'
  echo '{"format": {"description": "Date format string e.g. +%Y-%m-%d", "type": "string", "default": ""}}' >&2
  exit 0
fi
if [ -n "$format" ]; then
  date "$format"
else
  date
fi
EOF
chmod +x ~/mcpd-scripts/date
3

Start the mcpd server

Run mcpd pointing at your scripts directory. The server listens on port 1995 by default and opens a web dashboard.

./mcpd --script-root-directory ~/mcpd-scripts

# Or with Docker
docker run --rm -it -p 1995:1995 \
  -v "$(pwd)/scripts:/var/lib/mcpd" \
  ghcr.io/pouriya/mcpd:latest
4

Verify via the web dashboard

Open http://localhost:1995 in your browser to see the web dashboard, browse available tools, and run test calls.

5

Add mcpd to Claude Desktop config

Configure Claude Desktop to connect to the running mcpd server using the HTTP transport URL.

{
  "mcpServers": {
    "mcpd": {
      "url": "http://localhost:1995/api/mcp"
    }
  }
}

MCPD Examples

Client configuration

Claude Desktop and Cursor configuration connecting to a locally running mcpd server via HTTP transport.

{
  "mcpServers": {
    "mcpd": {
      "url": "http://localhost:1995/api/mcp"
    }
  }
}

Prompts to try

Example prompts after exposing scripts as mcpd tools.

- "What tools are available in mcpd?"
- "Run the date tool with format +%Y-%m-%d"
- "Execute my system-info script and summarize the output"
- "Run the calculator tool with expression 42 * 17"
- "Check the key-value store for the entry named 'config'"

Troubleshooting MCPD

Scripts are not appearing as tools

Ensure each script file is executable (chmod +x script) and returns valid JSON on stdout when called with --help. Parameter definitions must go to stderr. Run the script manually with --help to verify the output format matches mcpd's expectations.

Claude Desktop cannot connect to http://localhost:1995

By default mcpd binds to 127.0.0.1. Ensure mcpd is running before starting Claude Desktop, or set MCPD_HTTP_HOST=0.0.0.0 if connecting from a container. Check the port is not blocked by a firewall.

Permission denied when running the binary on macOS

macOS Gatekeeper may block unsigned binaries. Run: sudo xattr -rd com.apple.quarantine ./mcpd to remove the quarantine flag, then retry. You may also need to allow it in System Preferences > Security & Privacy.

Frequently Asked Questions about MCPD

What is MCPD?

MCPD is a Model Context Protocol (MCP) server that mcp server sdk for microcontrollers — expose esp32/rp2040 hardware as ai-accessible tools via model context protocol It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPD?

Follow the installation instructions on the MCPD GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPD?

MCPD works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPD free to use?

Yes, MCPD is open source and available under the BSD-3-Clause license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcpd": { "command": "npx", "args": ["-y", "mcpd"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPD?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides