Skip to main content

FastMCP Forge (Lite Edition)

fastmcp-forge MCP server

Free: Genesis Starter Kit (25 .cursorrules/CLAUDE.md rulesets + MCP configs). Try the live config builder. Full stack: all six servers in Genesis Enterprise Suite ($19).

License: MIT Python 3.10+ MCP Compliant

FastMCP Forge is an ergonomic framework and CLI scaffolding engine that enables Python developers to build, test, and package compliant Model Context Protocol (MCP) servers in seconds.


Run without cloning

uvx fastmcp-forge

Claude Desktop / Cursor config entry:

{
  "mcpServers": {
    "fastmcp-forge": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/johannschiffer/fastmcp-forge",
        "fastmcp-forge"
      ]
    }
  }
}

CI

⚡ The Problem: MCP Boilerplate Burnout

In 2026, every AI developer is building MCP servers to connect tools to Claude Desktop, Cursor, Windsurf, and Antigravity. However, writing raw JSON-RPC 2.0 handlers from scratch requires:

  • Manually parsing JSON schemas for tool arguments.
  • Handling error codes (-32600, -32601, -32602, -32000).
  • Managing sys.stdin and sys.stdout stream buffers.
  • Writing test harnesses to mock agent tool invocations.

FastMCP Forge gives you an intuitive @app.tool decorator that introspects function signatures, infers types, generates valid schemas, and creates automated test suites instantly.


🛠️ Code Example: Build an MCP Server in 10 Lines

from fastmcp_forge.server import FastMCP

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

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

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

🚀 CLI Project Scaffolder

Generate a full production-ready project with tests in 1 second:

python -m fastmcp_forge.cli new analytics-mcp

Output:

[OK] Created new FastMCP project 'analytics-mcp'
Generated files:
  - server.py
  - tests/test_server.py
  - README.md
  - requirements.txt

🖥️ Client Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "/path/to/my-server"
    }
  }
}

💎 Need Enterprise Remote Deployment? Upgrade to FastMCP Forge Pro

Deploying MCP servers as remote team microservices, behind authentication proxies, or in production clouds?

Feature Lite (Open Source) Enterprise Suite ($19)
@tool Schema Introspection ✅ ✅
JSON-RPC 2.0 stdio Transport ✅ ✅
CLI Project Scaffolding ✅ ✅
Dual Transport: stdio + Remote SSE HTTP ❌ ✅
Security & Auth Middleware (API Keys & Bearer Tokens) ❌ ✅
Token Bucket Rate Limiter ❌ ✅
Structured JSON Logs with Correlation IDs ❌ ✅
Multi-Stage Docker & Compose ❌ ✅
Full Pytest Suite & Enterprise Architecture Blueprint ❌ ✅

👉 Get the Genesis Enterprise Suite ($19)


📄 License

MIT License. See LICENSE for details.

VPS hosting that work well with FastMCP Forge. Some links are referral links.

Genesis MCP Ecosystem

Module What it does Repo
CrawlEngine MCP Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion GitHub
BrowserBridge MCP Deterministic headless browser automation with cryptographic action receipts GitHub
PgSafe MCP Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks GitHub
OmniBridge MCP Multi-channel notification and webhook bus with a persistent SQLite WAL queue GitHub
SysFlow MCP Safe Linux administration plane: systemd, port audit, isolated execution GitHub
FastMCP Forge (this repo) Production MCP server scaffolder: stdio, SSE and auth middleware GitHub

Live config builder | Starter Kit, free | Enterprise Suite, $19

Metadata

Release files for fastmcp-forge 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastmcp-forge 1.0.1
File Size Uploaded Provenance
fastmcp_forge-1.0.1.tar.gz 9.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for fastmcp-forge 1.0.1
File Interpreter ABI Platform
fastmcp_forge-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 19.2 kB

Release files / fastmcp_forge-1.0.1.tar.gz

Download URL fastmcp_forge-1.0.1.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f5d4fa8a5986ed9b6fe2d7c0505258a8b102ae966e299e1bb0ff9ff01cae691f
BLAKE2b-256 checksum
How to use checksums
6018c701594f4c9b158dd606ef2c14a2e92b9f90848824bf5cff4b6be6becbc8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / fastmcp_forge-1.0.1-py3-none-any.whl

Download URL fastmcp_forge-1.0.1-py3-none-any.whl
Size 10.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8ff8dbb1c21d783639f1a93e93b420827b290c58504c3d0aea246fa34f9e9421
BLAKE2b-256 checksum
How to use checksums
6b2f515e74318ef60008f74f25a7d510bcc5e4858fe7609ccafaf9651c448703
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for fastmcp-forge 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page