/ Directorio / Playground / GitMCP
● Comunidad idosal ⚡ Instantáneo

GitMCP

por idosal · idosal/git-mcp

Convierte cualquier repositorio público de GitHub en un punto final MCP en vivo: extrae su README, código y documentos en Claude sin clonar ni alucinar API.

GitMCP aloja un servidor MCP remoto en gitmcp.io/{owner}/{repo}. Claude obtiene herramientas para buscar documentación, buscar en el repositorio, enumerar archivos y leer rutas específicas, siempre en comparación con la rama principal actual. Elimina la clase de errores "Claude inventó una función que no existe" al usar bibliotecas desconocidas.

Por qué usarlo

Características clave

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 detener las API alucinantes de Claude para una biblioteca que conoce a medias

👤 Desarrolladores que utilizan bibliotecas más nuevas (posteriores al corte) o SDK de nicho ⏱ ~15 min beginner

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

Requisitos previos
  • Conoce la ruta de GitHub de la biblioteca — por ejemplo, pydantic/pydantic-ai: pega el propietario/repositorio en gitmcp.io
Flujo
  1. Añadir GitMCP apuntado a la biblioteca
    Agregue el servidor GitMCP para `pydantic/pydantic-ai' a mi configuración, luego enumere los archivos de documentos de nivel superior.✓ Copiado
    → La herramienta devuelve el árbol README.md plus /docs — no hay rutas fabricadas
  2. Preguntar contra fuente real
    Usando el GitMCP para pydantic-ai, muéstreme la firma del constructor real para Agent — cítelo de la fuente, no lo resuma.✓ Copiado
    → Firma exacta con archivo de origen + referencia de línea
  3. Verificar ejecutando
    Escriba un ejemplo ejecutable mínimo usando solo lo que vio en el repositorio. Si falta algo, dilo, no lo adivines.✓ Copiado
    → Ejemplo de compilaciones; Claude marca cualquier pieza que falte

Resultado: Integración de trabajo que coincida con la API real de la biblioteca, no con una ficción que suene plausible.

Errores comunes
  • La biblioteca está en un subdirectorio monorepo — Utilice primero la herramienta árbol para encontrar la raíz de paquete correcta antes de leer
Combinar con: context7 · github

Auditoría rápida de un repositorio de código abierto desconocido antes de bifurcar

👤 Ingenieros evaluando dependencias ⏱ ~10 min beginner

Cuándo usarlo: Estás a punto de adoptar una biblioteca y quieres saber en qué te estás metiendo sin clonar.

Flujo
  1. Resumen
    Utilice GitMCP para owner/repo. Resuma la arquitectura de README + directorios de nivel superior en 8 líneas.✓ Copiado
    → Resumen concreto anclado en el directorio, no pelusa de marketing
  2. Escaneo de riesgos
    Extraiga el manifiesto del paquete y enumere todas las dependencias. Marque cualquiera que parezca abandonado o que tenga un historial CVE conocido.✓ Copiado
    → Tabla de dependencias con evaluación por ítem
  3. Comprobación del ajuste
    ¿Hay alguna API de plugin/extensión que pueda usar, o tendría que bifurcar? Cita el código.✓ Copiado
    → Respuesta anclada en código con rutas de archivo

Resultado: Una decisión de bifurcación/adopción/omisión de 5 minutos respaldada por el contenido real del repositorio.

Errores comunes
  • Repo privado sin token — Utiliza la imagen autoalojada de Docker y configura GITHUB_TOKEN
Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

git-mcp-idosal + context7

Apilar dos capas de documentos actualizados: Contexto7 para documentos oficiales de SDK, GitMCP para la fuente de repositorio

Compare lo que dice context7 sobre Foo.bar() con la fuente real a través de GitMCP. ¿Alguna desviación?✓ Copiado
git-mcp-idosal + github

Use GitMCP para documentos de solo lectura y GitHub MCP para crear relaciones públicas/problemas

Lea la guía de contribución a través de GitMCP, luego abra una PR bien formada a través de GitHub MCP.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
fetch_documentation owner, repo Primera llamada al explorar un repositorio desconocido 1 GitHub API call
search_documentation owner, repo, query: str Encuentra secciones de documentos que mencionen un concepto específico 1 API call
fetch_url_content url: str Extraer archivo específico por URL sin formato free
search_code owner, repo, query: str Encontrar dónde se define o utiliza un símbolo 1 API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
GitHub no autenticado: 60 req/h por IP. Autenticado: 5000 req/h.
Tokens por llamada
500–5000 dependiendo del expediente
Monetario
Gratis (alojado)
Consejo
Utilice las herramientas search_* en lugar de volcar archivos enteros

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: public_repo (for private access)
Almacenamiento de credenciales: Token como env var en modo autoalojado
Salida de datos: gitmcp.io (alojado) o su propia instancia
No conceder nunca: repo:write

Resolución de problemas

Errores comunes y soluciones

Límite de tasa 403 excedido

Autoanfitrión con un PAT, o espera: el límite de no autenticación es de 60 req/h

Verificar: Check X-RateLimit-Remaining header
no encontrado

Revise la ortografía del propietario/repo y que sea pública. Para uso privado, utiliza una imagen autoalojada.

Devuelve contenido truncado

La API de GitHub limita el blob RAW a 1 MB. Use Search_CODE para archivos grandes.

Alternativas

GitMCP vs otros

AlternativaCuándo usarlaContrapartida
Context7Desea una superficie de documentos de biblioteca seleccionada en lugar de un repositorio RAWContext7 solo indexa un subconjunto; GitMCP cubre cualquier repositorio público
GitHub MCP (official)También necesita operaciones de relaciones públicas/problemas/escrituraGitHub MCP es capaz de escribir (más para bloquear); 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