GitMCP MCP — Installer & Démo en direct

Name: GitMCP MCP Server
Author: idosal

Pourquoi l'utiliser

Fonctionnalités clés

Zéro configuration — pointez simplement n'importe quel client MCP sur gitmcp.io/owner/repo
Toujours à jour — récupère la branche principale au moment de l'appel, sans embeddings périmés
Sensible à la doc — priorise le README et /docs plutôt que de déverser tous les fichiers
Fonctionne avec les dépôts privés via token (auto-hébergement)
Disponible en URL distante et en paquet npm pour l'hébergement local

Démo en direct

Aperçu en pratique

git-mcp-idosal.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": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

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": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "git-mcp-idosal",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "git-mcp-idosal": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://gitmcp.io/{owner}/{repo}"
        ]
      }
    }
  }
}

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

claude mcp add git-mcp-idosal -- npx -y mcp-remote https://gitmcp.io/{owner}/{repo}

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

Cas d'usage

Usages concrets : GitMCP

Comment empêcher Claude d'halluciner les API d'une bibliothèque qu'il connaît à moitié

👤 Devs utilisant des bibliothèques récentes (post-cutoff) ou des SDK de niche ⏱ ~15 min beginner

Quand l'utiliser : Vous intégrez une bibliothèque et Claude n'arrête pas d'inventer des noms de méthodes inexistants.

Prérequis

Connaître le chemin GitHub de la bibliothèque — Par exemple pydantic/pydantic-ai — collez le owner/repo dans gitmcp.io

Déroulement

Ajouter GitMCP pointé sur la bibliothèque

Ajoute le serveur GitMCP pour pydantic/pydantic-ai à ma configuration, puis liste les fichiers de doc de premier niveau.✓ Copié

→ L'outil retourne le README.md et l'arborescence /docs — aucun chemin inventé
Interroger la source réelle

En utilisant GitMCP pour pydantic-ai, montre-moi la signature exacte du constructeur Agent — cite-la depuis la source, ne la résume pas.✓ Copié

→ Signature exacte avec fichier source et référence de ligne
Vérifier en exécutant

Écris un exemple minimal exécutable en utilisant uniquement ce que tu as vu dans le dépôt. Si quelque chose manque, dis-le — ne devine pas.✓ Copié

→ L'exemple compile ; Claude signale les éléments manquants

Résultat : Une intégration fonctionnelle qui correspond à l'API réelle de la bibliothèque, pas à une fiction vraisemblable.

Pièges

La bibliothèque est dans un sous-répertoire monorepo — Utilisez d'abord l'outil tree pour trouver la bonne racine du paquet avant de lire

Combiner avec : context7 · github

Auditer rapidement un dépôt open source inconnu avant de le forker

👤 Ingénieurs évaluant des dépendances ⏱ ~10 min beginner

Quand l'utiliser : Vous êtes sur le point d'adopter une bibliothèque et voulez savoir ce que vous embarquez sans la cloner.

Déroulement

Vue d'ensemble

Utilise GitMCP pour owner/repo. Résume l'architecture à partir du README et des répertoires de premier niveau en 8 lignes.✓ Copié

→ Résumé ancré sur des répertoires concrets, pas du marketing
Analyse des risques

Récupère le manifeste du paquet et liste toutes les dépendances. Signale celles qui semblent abandonnées ou ayant un historique CVE connu.✓ Copié

→ Tableau de dépendances avec évaluation par entrée
Vérification de compatibilité

Y a-t-il une API de plugin/extension que je peux utiliser, ou faudrait-il forker ? Cite le code.✓ Copié

→ Réponse ancrée dans le code avec chemins de fichiers

Résultat : Une décision fork/adopter/ignorer en 5 minutes, étayée par le contenu réel du dépôt.

Pièges

Dépôt privé sans token — Utilisez l'image Docker auto-hébergée et définissez GITHUB_TOKEN

Combiner avec : github

Combinaisons

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

git-mcp-idosal + context7

Superposer deux couches de docs à jour — Context7 pour la doc SDK officielle, GitMCP pour la source du dépôt

Compare ce que context7 dit sur Foo.bar() avec la source réelle via GitMCP. Y a-t-il des divergences ?✓ Copié

git-mcp-idosal + github

GitMCP pour la lecture seule des docs, GitHub MCP pour créer des PR et issues

Lis le guide de contribution via GitMCP, puis ouvre une PR bien formée via GitHub MCP.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
fetch_documentation	owner, repo	Premier appel lors de l'exploration d'un dépôt inconnu	1 GitHub API call
search_documentation	owner, repo, query: str	Trouver les sections de doc mentionnant un concept précis	1 API call
fetch_url_content	url: str	Récupérer un fichier spécifique par son URL brute	free
search_code	owner, repo, query: str	Trouver où un symbole est défini ou utilisé	1 API call

Coût et limites

Coût d'exécution

Quota d'API: GitHub non authentifié : 60 req/h par IP. Authentifié : 5 000 req/h.
Tokens par appel: 500–5 000 selon le fichier
Monétaire: Gratuit (hébergé)
Astuce: Préférez les outils search_* plutôt que de déverser des fichiers entiers

Sécurité

Permissions, secrets, portée

Portées minimales : public_repo (for private access)

Stockage des identifiants : Token en variable d'environnement en mode auto-hébergé

Sortie de données : gitmcp.io (hébergé) ou votre propre instance

Ne jamais accorder : repo:write

Le point d'accès hébergé voit vos termes de requête — auto-hébergez si le sujet est couvert par un NDA

Dépannage

Erreurs courantes et correctifs

403 rate limit dépassé

Auto-hébergez avec un PAT, ou attendez — la limite non authentifiée est de 60 req/h

Vérifier : Check X-RateLimit-Remaining header

Dépôt introuvable

Vérifiez l'orthographe du owner/repo et que le dépôt est public. Pour un dépôt privé, utilisez l'image auto-hébergée.

Retourne un contenu tronqué

L'API GitHub plafonne les blobs bruts à 1 Mo. Utilisez search_code pour les gros fichiers.

Alternatives

GitMCP vs autres

Alternative	Quand l'utiliser	Compromis
Context7	Vous souhaitez une surface de docs de bibliothèque sélectionnée plutôt que la source brute du dépôt	Context7 n'indexe qu'un sous-ensemble ; GitMCP couvre n'importe quel dépôt public
GitHub MCP (official)	Vous avez besoin d'opérations d'écriture sur les PR, issues et code	GitHub MCP est en écriture (plus à verrouiller) ; GitMCP est en lecture seule

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills