fastmcp-forge

FastMCP Forge is a zero-dependency Python framework, CLI project scaffolder, and MCP server for building and testing Model Context Protocol (2024-11-05) servers over stdio or authenticated SSE transports.

Features

• @app.tool Decorator & Schema Inference: Introspects function signatures (including Optional[T], list[T], dict[K, V], and from __future__ import annotations) into JSON Schema definitions.
• Built-in MCP Server & CLI Scaffolder: Run fastmcp-forge new <name> from the terminal or connect fastmcp-forge directly to an MCP client to call scaffold_project and validate_project.
• Authenticated SSE Transport Handler: Constant-time API key and Bearer token verification (hmac.compare_digest), bounded session tracking with TTL expiration, and token-bucket rate limiting.

Quickstart

1. Run as an MCP Server (uvx)

{
  "mcpServers": {
    "fastmcp-forge": {
      "command": "uvx",
      "args": ["fastmcp-forge", "serve"]
    }
  }
}

Note: When invoked over a non-TTY pipe (uvx fastmcp-forge with no subcommand), fastmcp-forge automatically enters stdio MCP server mode.

Built-in MCP Tools

Tool	Description
scaffold_project	Generate a complete FastMCP server directory (server.py, tests/test_server.py, pyproject.toml, README.md, requirements.txt).
validate_project	Parse and verify an existing FastMCP project directory for syntax and structure.

2. CLI Project Scaffolder

pip install fastmcp-forge
fastmcp-forge new analytics-mcp
fastmcp-forge validate ./analytics-mcp

3. Build a Custom Server in Python

from fastmcp_forge.server import FastMCP

app = FastMCP(name="math-mcp", version="2.0.1")


@app.tool(description="Multiply two numbers")
def multiply(a: float, b: float) -> float:
    return a * b


if __name__ == "__main__":
    app.run()

Genesis MCP Ecosystem

Module	Description	Repository
CrawlEngine MCP	HTTP web extraction to clean Markdown, JSON-LD parsing, and proxy rotation	GitHub
BrowserBridge MCP	Lightweight HTTP/DOM session automation with SHA-256 action receipts	GitHub
PgSafe MCP	Read-only PostgreSQL/SQLite query guard, PII masking, and dry-run mutations	GitHub
OmniBridge MCP	Multi-channel notification bus with SQLite retry queue	GitHub
SysFlow MCP	Linux systemd inspection, confined log tailing, and port auditing	GitHub
FastMCP Forge	Zero-dependency FastMCP framework, CLI scaffolder, and SSE middleware	GitHub

Support

If you find this project useful, you can support maintenance on Ko-fi.

License

MIT (c) 2026 Johann Schiffer