mcpd
Run your agents, not your infrastructure.
mcpd is a toolchain and runtime developed by Mozilla AI that simplifies the configuration,
execution and integration of Model Context Protocol (MCP) servers with your agentic application.
It is intended to provide the same experience across local development and production environments.
It removes the friction of cross-language server orchestration, secrets management, version pinning, and lifecycle control.
✨ Why mcpd?
Traditional agent frameworks often embed complex subprocess logic, brittle startup scripts, and ad-hoc 'desktop style' config.
mcpd replaces this with:
🧪 Zero-Config Tool Setup
No cloning repos or installing language-specific dependencies. mcpd add and mcpd daemon handle everything.
🌍 Language-Agnostic Tooling
Use MCP servers written in Python (uvx), JavaScript/TypeScript (npx) in your code via a HTTP REST API that supports routing to MCP Servers.
🧭 Declarative Tool Management
Define version-pinned MCP servers and tools in .mcpd.toml. Reproducible, consistent, and CI-friendly.
🔐 Project config separated from runtime variables
Args and environment variables per server e.g. ~/.config/mcpd/secrets.dev.toml. Never commit dev specific vars to Git again.
🛠️ Unified Dev Experience
One command: mcpd daemon. Starts and manages all servers behind the scenes.
🧰 Intuitive SDK Integration
The Python mcpd_sdk makes calling tools feel like native function calls; no HTTP, STDIO, or SSE boilerplate.
Even easier for users of any-agent via .agent_tools().
🚀 Seamless Local-to-Prod Transition
The same .mcpd.toml and agent code work in dev, CI, and cloud environments without modification.
🏗️ Built for Dev & Infra
| Feature | Dev Workflow | Production Benefit |
|---|---|---|
.mcpd.toml |
Version-controlled agent tool spec | Declarative IaC for tools |
mcpd daemon |
Run everything locally | Run in container alongside your agentic app |
mcpd config export |
Discover required vars | Populate CI/CD pipelines |
| Secure secrets store | Local overrides per dev | Injected via Control Plane |
| Same binary | Local builds | Cloud deployment |
| SDKs for Python | Iterate locally | Plug into prod orchestrators |
🌐 Deploy Anywhere
mcpd is runtime-flexible and infrastructure-agnostic:
- ⚙️ Works in any container or host with
uvandnpx(NodeJS) - ☁️ Multi-cloud ready (AWS, GCP, Azure, on-prem)
- ♻️ Low resource overhead via in-process server management
📚 Explore the Docs
Use the sidebar to explore:
- ✅ Requirements
- ⚙️ Configuration
- 🧭 CLI Reference
- 🧵 Execution context and secrets
- 🛠️ Makefile and tooling
- 📚 Tutorial
🌐 About Mozilla AI
This project is built and maintained by Mozilla AI, a mission-driven organization reimagining AI for the public good.
Have ideas or feedback? Contributions welcome via GitHub.