Skillget

mcpd

mcp
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Pass
  • Code scan — Scanned 5 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

An MCP daemon for automated tool registration.

README.md

mcpd

Register MCP servers once. Give your agents one connection.

mcpd routes tools, resources, and prompts from registered stdio servers through a single MCP endpoint. Backends start on demand; registration changes take effect on the next discovery call. Supports MCP 2026-07-28 and legacy 2025-11-25 clients and servers.

Install and connect

cargo install mcpd --locked
mcpd register <name> <command> [args...]

Add -e KEY=VALUE to a registration to set backend environment variables. Use mcpd list to inspect registrations and mcpd unregister <name> to remove one. The registry lives in your OS config directory under mcpd/registry.json.

Configure your MCP client to launch mcpd serve over stdio:

{
  "mcpServers": {
    "mcpd": { "command": "mcpd", "args": ["serve"] }
  }
}

On Unix systems, mcpd serve transparently connects stdio to a shared daemon at $XDG_RUNTIME_DIR/mcpd.sock, starting it when needed. Concurrent Codex, Claude, and Pi sessions share backend processes without changing their existing mcpd serve configuration. The socket is created with user-only permissions. mcpd daemon remains available for starting the shared process explicitly.

Connect an agent client with the matching setup command:

mcpd setup pi
mcpd setup codex
mcpd setup claude

Pi installs a bundled extension and requires /reload. Codex and Claude are configured through their native MCP commands. Repeat setup after upgrading mcpd.

Discover and use

Agents see three tools regardless of backend count:

Tool Purpose
find_tools Search server names, tool names, and descriptions; return ranked matches with input schemas.
list_tools Return the complete backend tool catalog.
use_tool Call a discovered server__tool with tool_name and arguments.

Start with find_tools({"query":"file search"}). Search matches any keyword, ignoring case, and favors names over descriptions. Omit query to browse; use server for an exact server filter. limit defaults to 10 (maximum 100). Results include total_matches, registered servers, and backend errors; each backend gets 15 seconds to respond.

Resources and prompts use standard MCP methods. Names become server__name; resource URIs become mcpd://server/original-uri. Backends lacking either capability are skipped.

Integration and development details | MIT license

Reviews (0)

No results found