Skip to main content
Glama
Sign In
FastMCP Forge

FastMCP Forge

by johannschiffer
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

fastmcp-forge

PyPI version CI License: MIT Python 3.10+ MCP Compliant

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.

Related MCP server: mcpserve

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

Available Tools

2 tools
scaffold_projectC

Scaffold a new FastMCP server project with tests and configuration

Inputs: project_name (required), target_dir.

validate_projectB

Validate an existing FastMCP project directory for syntax and structure

Inputs: project_dir (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools perform clearly opposite-lifecycle actions: scaffold_project creates a new project, validate_project checks an existing one. There is no realistic way to confuse them, and both descriptions state the target resource explicitly.

    Naming Consistency5/5

    Both names follow a clean verb_noun snake_case pattern (scaffold_project, validate_project). The convention is uniform with no deviations.

    Tool Count3/5

    Two tools is thin for a server whose scope is the full FastMCP project lifecycle; it sits at the borderline where each tool is essential but the surface feels minimal. A handful more operations (e.g. add a tool, run tests) would make the set feel complete rather than a pair of one-off utilities.

    Completeness3/5

    Creation and validation are covered, but there is no way to modify an existing scaffold, inspect a project, or run/test it — an agent that scaffolds, edits, and then needs to regenerate or verify a broken project hits a dead end beyond a single validate call. Notable lifecycle gaps remain.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • nbmcp

      rum1887
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables building lightweight MCP servers where Rust handles transport, routing, and schema validation while Python defines tool behavior using type hints, with support for stdio and HTTP transports.
      MIT

    • mcpserve

      AmirNaghibi
      A
      license
      Not graded
      quality
      B
      maintenance
      A minimal, decorator-based framework for building MCP servers in Python with zero dependencies. It enables you to define tools and resources via simple decorators, handling JSON-RPC protocol, type inference, and stdio transport automatically.
      MIT

    • cli2mcp

      yulinlina
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables turning any command-line tool into an MCP server with auto-generated JSON schema, supporting stdio, timeouts, and stderr capture.
      MIT

    • mcp-agent-kit

      hummbl-dev
      A
      license
      A
      quality
      B
      maintenance
      Enables building and running zero-dependency MCP servers with automatic JSON Schema generation, exposing Python tools to Claude Desktop, Cursor, and autonomous agent fleets.
      2
      Apache 2.0