mcp-forge

mcp-forge is an innovative framework designed to facilitate the creation of Model Context Protocol (MCP) servers using Python. This FastAPI-style framework excels in providing a streamlined development experience by eliminating boilerplate code and optimizing productivity through declarative tools. With mcp-forge, developers can focus on writing clear business logic without the distractions of extensive configurations or manual schema definitions.

Key Features

• Declarative Tools: Utilize the @app.tool() decorator for seamless tool creation without the need for schema files or additional registration calls.
• Auto JSON Schema: Automatically generate JSON Schema using Pydantic v2 from type hints, ensuring accurate representation and validation of data structures.
• Run-time Validation: Ensure that inputs are validated before execution, allowing for reliable error handling in compliance with MCP specifications.
• Multi-Transport Support: Easily switch between STDIO, HTTP, and SSE transport protocols without altering the underlying logic, simplifying deployment in various environments.
• Async-First Design: Both asynchronous and synchronous functions can coexist effortlessly, relieving developers from managing complex event loops.
• Easy Testing: The built-in ForgeTestClient enables straightforward unit tests without needing a running server, providing immediate feedback during development.
• Typed and Strict: Adheres to strict typing conventions, fully supporting mypy checks and ensuring code reliability.

Quick Usage Example

from mcp_forge import Forge

app = Forge(name="my-server", version="1.0.0")

@app.tool(description="Search the knowledge base")
async def search(query: str, limit: int = 10) -> list[dict]:
    """Returns ranked results for the given query."""
    ...  # your logic here

if __name__ == "__main__":
    app.run()  # STDIO — Claude Desktop / Cursor / VS Code ready

Core Development Principles

mcp-forge operates on several core principles:

• Schema Generation: JSON Schema is derived from type hints, eliminating the need for manual declarations.
• Flexible Transport Handling: Transport types can be changed at runtime without impacting application logic.
• Opt-In Contribution: Developers have control over which features to include, promoting a lightweight setup.
• Testing and Validation: Validate functionality consistently during development, ensuring a robust production-ready application.

Ecosystem Compatibility

mcp-forge supports various clients and transports, including:

• Claude Desktop (STDIO)
• Cursor (STDIO)
• VS Code (both STDIO and HTTP)
• Custom LLM agents (HTTP and SSE)

For full installation instructions and contributing guidelines, the documentation available provides comprehensive support.

Utilize mcp-forge to develop MCP servers efficiently while taking advantage of its powerful features and simple syntax. Explore more about the framework and contribute to the project within the Benni OS community.