mcp-go (SDK) — Cas d'usage, Installer & Démo en direct

Name: mcp-go (SDK) MCP Server
Author: mark3labs

Pourquoi l'utiliser

Fonctionnalités clés

Transports stdio + SSE + HTTP streamable
Enregistrement d'outils type-safe avec les generics Go
Support ressources et prompts out of the box
Négociation de capacités intégrée
Compatible avec la dernière spécification MCP

Démo en direct

Aperçu en pratique

mcp-go-mark3labs.replay ▶ prêt

0/0

Installer

Choisissez votre client

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

{
  "mcpServers": {
    "mcp-go-mark3labs": {
      "command": "go",
      "args": [
        "install",
        "github.com/mark3labs/mcp-go/cmd/example@latest"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

{
  "mcpServers": {
    "mcp-go-mark3labs": {
      "command": "go",
      "args": [
        "install",
        "github.com/mark3labs/mcp-go/cmd/example@latest"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-go-mark3labs": {
      "command": "go",
      "args": [
        "install",
        "github.com/mark3labs/mcp-go/cmd/example@latest"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-go-mark3labs": {
      "command": "go",
      "args": [
        "install",
        "github.com/mark3labs/mcp-go/cmd/example@latest"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-go-mark3labs",
      "command": "go",
      "args": [
        "install",
        "github.com/mark3labs/mcp-go/cmd/example@latest"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-go-mark3labs": {
      "command": {
        "path": "go",
        "args": [
          "install",
          "github.com/mark3labs/mcp-go/cmd/example@latest"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add mcp-go-mark3labs -- go install github.com/mark3labs/mcp-go/cmd/example@latest

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : mcp-go (SDK)

Construire un serveur MCP interne pour votre API d'entreprise en moins de 100 LOC

👤 Développeurs Go dans des entreprises souhaitant exposer des outils internes à Claude ⏱ ~45 min intermediate

Quand l'utiliser : Vous avez un service Go et voulez que Claude le call sans écrire de schémas OpenAPI.

Prérequis

Go 1.21+ — Installez via brew ou asdf

Déroulement

Scaffolding du serveur

Create a new Go project. Add mcp-go and define one tool: search_orders(customer_id) that calls our internal /v1/orders API.✓ Copié

→ main.go ~50 lignes, build propre
Tester avec mcp-inspector

Run the server in stdio mode. Open mcp-inspector and verify the tool shows up.✓ Copié

→ Outil appelable depuis l'inspector
Enregistrer dans Claude

Add the binary to claude_desktop_config.json. Test from Claude with a real customer ID.✓ Copié

→ Réponse live depuis l'API

Résultat : API Go interne exposée à Claude avec des outils MCP type-safe.

Pièges

Les appels longue durée bloquent stdio — Utilisez le transport SSE ou HTTP streamable pour les appels >5s

Combiner avec : mcp-python-sdk

Porter une API REST existante vers MCP sans casser les clients REST

👤 Équipes backend adoptant MCP sans forcer la migration ⏱ ~60 min intermediate

Quand l'utiliser : Vous voulez que REST et MCP coexistent sur les mêmes handlers.

Déroulement

Extraire la logique du handler

Take the existing /api/v1/search handler. Extract the core function so both gin and mcp-go can call it.✓ Copié

→ Handler splitté — le handler http délègue à une fonction pure
Envelopper dans un outil MCP

Register the pure func as an mcp-go tool. Map URL params to tool inputs.✓ Copié

→ Même logique, deux surfaces
Binaire unique, deux transports

Build one binary that runs gin on :8080 and the MCP server over stdio when invoked with --mcp.✓ Copié

→ Binaire multi-mode

Résultat : REST et MCP servis depuis un seul binaire Go avec un cœur partagé.

Héberger un serveur MCP sur internet public avec SSE

👤 Développeurs publiant des MCPs publics (comme git-mcp.io) ⏱ ~90 min advanced

Quand l'utiliser : Vous voulez que les utilisateurs ajoutent votre MCP sans rien installer localement.

Prérequis

Un domaine et TLS — Caddy/nginx avec Let's Encrypt

Déroulement

Basculer vers le transport SSE

Convert the stdio server to SSE. Add CORS for the relevant origins.✓ Copié

→ Serveur acceptant les connexions /sse
Ajouter l'auth par utilisateur

Validate Bearer token on each connection; reject unknown.✓ Copié

→ 401 sur les mauvais tokens, ok sur les valides
Déployer + tester

Deploy to fly.io. Add the URL to Claude via mcp-remote.✓ Copié

→ Outil appelable depuis Claude pointant vers l'URL distante

Résultat : Serveur MCP public sur internet avec auth, prêt pour les utilisateurs.

Pièges

SSE derrière un load balancer coupe les longues connexions — Configurez les délais d'inactivité >5min sur le LB

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcp-go-mark3labs + mcp-python-sdk

Même projet mais deux SDKs pour des surfaces différentes

Use mcp-go for the perf-critical core; mcp-python-sdk for the data-science adjacency.✓ Copié

mcp-go-mark3labs + mcp-registry

Publier votre MCP construit dans le registry officiel

Once your mcp-go server works, submit it to the modelcontextprotocol/registry.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
AddTool	name, description, handler	Au démarrage du serveur pour chaque outil
AddResource	uri, name, handler	Exposer une ressource lisible
AddPrompt	name, description, handler	Exposer des prompts réutilisables
ServeStdio	()	Mode stdio local (le plus courant)
ServeSSE	addr, opts	Mode réseau/distant

Coût et limites

Coût d'exécution

Quota d'API: N/A — bibliothèque
Tokens par appel: N/A
Monétaire: Gratuit (MIT)
Astuce: Épinglez à une version mineure spécifique ; l'API s'est stabilisée en 2025 mais des deltas mineurs arrivent

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Ce dont vos handlers d'outils ont besoin

Sortie de données : Contrôlé par vos handlers

Dépannage

Erreurs courantes et correctifs

Outil non visible pour Claude

Vérifiez que les capacités sont négociées ; les outils doivent être enregistrés avant l'appel ServeStdio

Vérifier : Use mcp-inspector to confirm tool listing

Messages stdio mal formés

N'imprimez pas sur stdout dans vos handlers — c'est le canal JSON-RPC. Utilisez stderr pour les logs.

SSE chute à l'inactivité

Ajoutez des keepalives périodiques ; configurez les délais d'expiration du proxy

Alternatives

mcp-go (SDK) vs autres

Alternative	Quand l'utiliser	Compromis
mcp-python-sdk (official)	Vous codez en Python	Langage différent ; les deux sont de premier ordre
TypeScript SDK (official)	Écosystème Node/Bun adapté	JS en premier ; moins de marge de performance que Go

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills