modular-mcp 0.3.0

A modular companion package for the Model Context Protocol SDK, designed to extend functionality with a clean and decoupled architecture.

Modular MCP (Model Context Protocol Companion)

Modular MCP is a standalone Python package designed to extend and organize MCP servers in a clean and scalable way. It is not a fork, but a modular companion to the Model Context Protocol SDK, developed and maintained by Damyan Dimitrov (GitHub).

---

✨ Purpose

The purpose of this package is to enable modular development of MCP servers by introducing a Bundle system, similar in spirit to FastAPI's APIRouter. It provides:

• Clean separation of tools, resources, and prompts
• Easy composition of multiple components
• Scalable, maintainable codebases for MCP servers

This package works independently, but when used together with the mcp SDK, it unlocks powerful features like ModularFastMCP.

---

📦 Installation

To install modular-mcp:

uv add modular-mcp

To use it with the official mcp SDK (as an optional dependency):

uv add "modular-mcp[mcp]"

---

🛠 Usage

Example of running a server using uv:

uv venv
uv add -e .[mcp]
uv run mcp

You can define and include multiple bundles to organize your project by domain or feature set.

---

📚 Learn More

For background on the MCP SDK and ecosystem:

👉 Model Context Protocol Python SDK

---

📝 License

MIT License — same as the original MCP SDK.