GitMCP MCP — Instalar & Demo en vivo

Name: GitMCP MCP Server
Author: idosal

Por qué usarlo

Características clave

Sin configuración — apunta cualquier cliente MCP a gitmcp.io/owner/repo
Siempre actualizado — obtiene la rama principal en el momento de la llamada, sin embeddings obsoletos
Consciente de la documentación — prioriza README y /docs antes de volcar todos los archivos
Funciona con repositorios privados mediante token (autohospedado)
Disponible como URL remota y paquete npm para hospedaje local

Demo en vivo

Cómo se ve en la práctica

git-mcp-idosal.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/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}"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: GitMCP

Cómo evitar que Claude invente APIs de una librería que conoce a medias

👤 Desarrolladores que usan librerías recientes (posteriores al corte) o SDKs de nicho ⏱ ~15 min beginner

Cuándo usarlo: Estás integrando una librería y Claude sigue inventando nombres de métodos que no existen.

Requisitos previos

Conocer la ruta de GitHub de la librería — Por ejemplo pydantic/pydantic-ai — pega owner/repo en gitmcp.io

Flujo

Añadir GitMCP apuntando a la librería

Add the GitMCP server for pydantic/pydantic-ai to my config, then list the top-level docs files.✓ Copiado

→ La herramienta devuelve README.md y el árbol de /docs — sin rutas inventadas
Consultar contra el código fuente real

Using the GitMCP for pydantic-ai, show me the actual constructor signature for Agent — quote it from source, don't summarize.✓ Copiado

→ Firma exacta con archivo fuente y referencia de línea
Verificar ejecutando

Write a minimal runnable example using only what you saw in the repo. If something is missing, say so — don't guess.✓ Copiado

→ El ejemplo compila; Claude señala cualquier pieza faltante

Resultado: Una integración funcional que coincide con la API real de la librería, no con una ficción plausible.

Errores comunes

La librería está en un subdirectorio de un monorepo — Usa la herramienta tree primero para encontrar la raíz correcta del paquete antes de leer

Combinar con: context7 · github

Auditoría rápida de un repositorio open source desconocido antes de hacer fork

👤 Ingenieros evaluando dependencias ⏱ ~10 min beginner

Cuándo usarlo: Estás a punto de adoptar una librería y quieres saber en qué te metes sin clonarla.

Flujo

Visión general

Use GitMCP for owner/repo. Summarize the architecture from README + top-level directories in 8 lines.✓ Copiado

→ Resumen concreto anclado en directorios, sin palabrería de marketing
Análisis de riesgos

Pull the package manifest and list every dependency. Flag any that look abandoned or have known CVE history.✓ Copiado

→ Tabla de dependencias con evaluación por elemento
Comprobación de compatibilidad

Is there a plugin/extension API I can use, or would I need to fork? Cite the code.✓ Copiado

→ Respuesta anclada en código con rutas de archivo

Resultado: Una decisión de fork/adoptar/descartar en 5 minutos respaldada por el contenido real del repositorio.

Errores comunes

Repositorio privado sin token — Usa la imagen Docker autohospedada y configura GITHUB_TOKEN

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

git-mcp-idosal + context7

Combinar dos capas de documentación actualizada: Context7 para los docs oficiales del SDK, GitMCP para el código fuente del repositorio

Compare what context7 says about Foo.bar() with the actual source via GitMCP. Any drift?✓ Copiado

git-mcp-idosal + github

Usar GitMCP para documentación de solo lectura y GitHub MCP para crear PRs e issues

Read the contribution guide via GitMCP, then open a well-formed PR via GitHub MCP.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
fetch_documentation	owner, repo	Primera llamada al explorar un repositorio desconocido	1 GitHub API call
search_documentation	owner, repo, query: str	Encuentra secciones de la documentación que mencionan un concepto específico	1 API call
fetch_url_content	url: str	Obtener un archivo específico por URL directa	free
search_code	owner, repo, query: str	Encontrar dónde se define o usa un símbolo	1 API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: GitHub sin autenticar: 60 solicitudes/h por IP. Autenticado: 5000 solicitudes/h.
Tokens por llamada: 500–5000 según el archivo
Monetario: Gratuito (hospedado)
Consejo: Usa las herramientas search_* en lugar de volcar archivos completos

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: public_repo (for private access)

Almacenamiento de credenciales: Token como variable de entorno en modo autohospedado

Salida de datos: gitmcp.io (hospedado) o tu propia instancia

No conceder nunca: repo:write

El endpoint hospedado ve los términos de tu consulta — autohospeda si el contenido es confidencial bajo NDA

Resolución de problemas

Errores comunes y soluciones

403 rate limit exceeded

Autohospeda con un PAT, o espera — el límite sin autenticar es 60 solicitudes/h

Verificar: Check X-RateLimit-Remaining header

Repositorio no encontrado

Verifica la ortografía de owner/repo y que sea público. Para repositorios privados, usa la imagen autohospedada.

Devuelve contenido truncado

La API de GitHub limita los blobs a 1 MB. Usa search_code para archivos grandes.

Alternativas

GitMCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Context7	Prefieres una superficie de documentación curada en lugar del repositorio en bruto	Context7 solo indexa un subconjunto; GitMCP cubre cualquier repositorio público
GitHub MCP (official)	También necesitas operaciones de escritura como PRs e issues	GitHub MCP tiene capacidad de escritura (más que proteger); GitMCP es de solo lectura

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills