mcpd

mcpd is a CLI and local daemon that helps developers and infrastructure teams manage Model Context Protocol (MCP) servers declaratively, with the same experience locally and in production.

Built by Mozilla AI

🚀 Features

• Declarative .mcpd.toml to define servers/tools
• Run and manage language-agnostic MCP servers via a single CLI
• Secure execution context for secrets and runtime args
• Smooth dev-to-prod transition via the mcpd daemon
• Rich CLI and SDK tooling, see supported languages below:

Language	Repository	Status
Python	mcpd-sdk-python	✅
JavaScript	Coming soon	🟡

📖 Documentation

Full documentation available at:

👉 https://mozilla-ai.github.io/mcpd/

Covers setup, CLI usage, configuration, secrets, the daemon, Makefile commands, and full tutorials.

Explore the Python SDK, with a list of examples using it with different agent frameworks, at:

👉 https://github.com/mozilla-ai/mcpd-sdk-python

⚙️ Quickstart

Install dependencies:

• Go
• npx
• uvx

Clone the repo:

git clone [email protected]:mozilla-ai/mcpd.git
cd mcpd

Build the binary:

make build

Install globally:

sudo make install

In your agentic application code...

Initialize a new project:

mcpd init

Add a server (e.g. time):

mcpd add time

Start the daemon:

mcpd daemon

API docs will be available at /docs, e.g. http://localhost:8090/docs

🧰 Development

Run tests:

make test

Run the local documentation site (requires uv):

make docs-local

Generate CLI documentation and related docs site navigation:

make docs-cli
make docs-nav

---

🤝 Contributing

Please see our Contributing to mcpd guide for more information.

📄 License

Licensed under the Apache License 2.0.