FastMCP Forge (Lite Edition)
Free: Genesis Starter Kit (25
.cursorrules/CLAUDE.mdrulesets + MCP configs). Try the live config builder. Full stack: all six servers in Genesis Enterprise Suite ($19).
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"
]
}
}
}
⚡ 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.stdinandsys.stdoutstream 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.
Recommended Infrastructure
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| fastmcp_forge-1.0.1.tar.gz | 9.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.