#3434th of 64 in Agent and MCP starters

golf

Python framework that compiles tool, resource and prompt files into an MCP server

Stars
843
License
Apache-2.0
Last commit
Sep 2026
Last release
Sep 2026
Language
Python

Missed the latest GitHub check; these facts may be older.

Overview

Golf builds an MCP server from a directory of Python files: each file in tools/, resources/ or prompts/ defines one component, and the component ID is derived from its path. It targets FastMCP 4.0.0 and MCP 2026-07-28, with legacy client compatibility. Authentication (JWT, OAuth server mode, static dev tokens) is configured in auth.py, and OpenTelemetry tracing is switched on through golf.json or environment variables.

Who it is for: Python developers building and self-hosting MCP servers

Strengths

  • File-per-component layout; tool schemas inferred from function signatures and Pydantic models
  • Auth options in auth.py: JWT with JWKS, OAuth 2.0 server mode, static dev tokens
  • Optional OpenTelemetry tracing, with a detailed_tracing flag for input/output capture
  • Supports streamable-http and stdio transports; targets MCP 2026-07-28 with legacy compatibility

Weaknesses

  • Collects anonymous CLI usage telemetry by default; opt-out needed
  • v0.2.0 auth API is a breaking change from v0.1.x
  • Under MCP 2026-07-28, elicit and sample need InputRequiredResult return handling in tools
  • SSE transport is deprecated; no Docker or compose files provided

What it needs

  • Python
  • Needs Python 3.10+, FastMCP 4.0.0

Also in Agent and MCP starters

See all 64
Also in Agent and MCP starters
RankProjectScore
1deepseek-harnessPlugin-based agent harness from DeepSeek with a local Web UI279.6k stars+32,096 (+13%) in 30 daysMIT98 out of 100
2composioTypeScript and Python SDKs that give agents authenticated tools across 1000+ apps31k stars+574 (+1.9%) in 30 daysMIT92 out of 100
3conductorDurable workflow engine that orchestrates microservices and LLM agents from JSON32.5k starsApache-2.091 out of 100
#4mcp-useTypeScript framework for building MCP servers with React Views and an Inspector Live demo ↗ (opens in a new tab)10.9k stars+132 (+1.2%) in 30 daysMIT87 out of 100
#5a2uiProtocol and renderers for agents to stream native UI instead of text Live demo ↗ (opens in a new tab)17.2k starsApache-2.086 out of 100