Golf MCP Server

What is Golf?

Golf is a framework for building MCP (Model Context Protocol) servers. It allows developers to define server capabilities—tools, prompts, and resources—as simple Python files within a conventional directory structure, then automatically discovers and compiles them into a runnable MCP server. Golf is designed for Python developers who want to create MCP servers with minimal boilerplate, and includes built-in authentication, utilities for LLM interactions, and automatic telemetry.

How to use Golf?

Install Golf with pip install golf-mcp (Python 3.10+ required). Initialize a project using golf init your-project-name. Run the development server with golf build dev && golf run. Components are defined in tools/, resources/, and prompts/ directories; each Python file defines one component, with its module docstring serving as the description. Authentication is configured in an auth.py file using the configure_auth function.

Key features of Golf

• Automatic discovery and compilation of tools, prompts, and resources.
• Built-in authentication: JWT, OAuth Server, API key, and development tokens.
• OpenTelemetry integration for tracing.
• CLI scaffolding with golf init and golf run.
• Support for multiple transports: SSE, Streamable HTTP, and stdio.
• Telemetry with anonymous usage data and opt-out capability.

Use cases of Golf

• Rapidly prototyping an MCP server for an AI assistant that needs custom tools.
• Building a production-ready MCP server with enterprise-grade authentication.
• Creating a modular MCP server where capabilities are organized in separate files.
• Developing an MCP server with built-in monitoring via OpenTelemetry.
• Teaching or learning MCP server development with a simplified structure.