golf MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Auto-discovers tools/prompts/resources from directory conventions
Enterprise auth: JWT, OAuth server, API keys, dev tokens
Optional OpenTelemetry — traces tool calls to your existing observability
Minimal boilerplate; focus on the tool logic

Demo ao vivo

Como fica na prática

golf.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "golf": {
      "command": "uvx",
      "args": [
        "golf"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "golf": {
      "command": "uvx",
      "args": [
        "golf"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "golf": {
      "command": "uvx",
      "args": [
        "golf"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "golf": {
      "command": "uvx",
      "args": [
        "golf"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "golf",
      "command": "uvx",
      "args": [
        "golf"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "golf": {
      "command": {
        "path": "uvx",
        "args": [
          "golf"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add golf -- uvx golf

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: golf

Build an internal company MCP with Golf

👤 Platform engineers ⏱ ~60 min advanced

Quando usar: You want a single authenticated MCP exposing 20+ internal tools (Jira, Grafana, ticketing) to employees via Claude.

Pré-requisitos

Python 3.11+, uv — astral.sh/uv

Fluxo

Scaffold

Run uvx golf new acme-mcp and cd in.✓ Copiado

→ Project with tools/, prompts/, resources/ dirs
Drop in tool files

Create tools/list_tickets.py exporting an async function. Golf wires the schema automatically.✓ Copiado

→ Tool visible at /tools list
Enable JWT auth tied to your IdP

Configure golf.yaml auth: jwt with your IdP's JWKS URL. Require mcp:use scope.✓ Copiado

→ Unauthenticated calls rejected

Resultado: A deployable MCP that only authorized employees can call, with traces flowing to your APM.

Armadilhas

Each tool import failure breaks server startup — Golf loads tools eagerly — fix import errors or move heavy deps inside the function

Ship an MCP with OpenTelemetry from day one

👤 SREs, observability engineers ⏱ ~30 min advanced

Quando usar: You already run OTel collectors and want agent tool calls to appear in traces.

Fluxo

Enable telemetry

In golf.yaml, enable telemetry.otlp with your collector endpoint.✓ Copiado

→ Tool calls appear as spans in your OTel backend
Tag traces with user id from auth

Add a middleware that sets user.id on each span from the JWT sub.✓ Copiado

→ Per-user call graphs

Resultado: MCP usage is a first-class citizen in your existing observability.

Combine com: prometheus

Version prompts alongside code with Golf

👤 Prompt engineers ⏱ ~25 min intermediate

Quando usar: Your prompts live in a Notion and drift from what's actually deployed.

Fluxo

Move prompts into prompts/ dir

Create prompts/triage.py with a prompt template and variables.✓ Copiado

→ Prompt appears in MCP /prompts/list
CI-verify on every commit

Add a test that renders each prompt with sample inputs to catch breaking changes✓ Copiado

→ Regression safety for prompt edits

Resultado: Prompts ship through the same PR process as code.

Combinações

Combine com outros MCPs para 10× de alavancagem

golf + hyper

Compare a Python-based Golf server against a WASM hyper-mcp plugin model

I have the same tool in Golf and hyper-mcp. Run latency & memory comparison across 100 calls each.✓ Copiado

golf + prometheus

Scrape Golf's metrics endpoint into Prometheus

Point my Prometheus at golf's /metrics, then query p99 tool latency with prometheus-mcp.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
golf new <name>	project_name: str	Start a new server
golf build		Compile tool directories into a server binary/image
golf run	--transport stdio\|http	Local dev or production launch

Custo e limites

O que custa rodar

Cota de API: None — framework runs wherever you host it
Tokens por chamada: Depends on tools
Monetário: Free, open source
Dica: Enable telemetry sampling in production (e.g. 10% of tool calls) to control OTel ingest cost

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: JWT/OAuth secrets via env; Golf never logs them by default

Saída de dados: Wherever your tools call

Solução de problemas

Erros comuns e correções

Tool not showing in tools list

Check the file exports the async function with the exact name Golf expects (see framework docs); missing __tool__ metadata is the most common cause

Verificar: golf run --debug shows discovery log

JWT validation fails with valid token

JWKS URL unreachable or wrong issuer. Verify with curl; check clock skew on host

Traces not appearing in OTel backend

Golf uses OTLP/HTTP — ensure collector has that receiver enabled, not just gRPC

Verificar: curl -v $OTLP_ENDPOINT/v1/traces

Alternativas

golf vs. outros

Alternativa	Quando usar	Troca
FastMCP	You want something simpler without auth/telemetry features	BYO production concerns
MCP-Nest (NestJS)	Your team is a NestJS shop	TypeScript only
Arcade	Focus on distribution/sharing as much as building	Slightly different target audience

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills