GitMCP

Transforma cualquier proyecto de GitHub en un centro de documentación, permitiendo que las herramientas de IA accedan a documentación y código actualizados.

GitHub

8.5k

Documentación

GitMCP

¿Qué es GitMCP? • Características • Primeros pasos • Cómo funciona • Insignia • Ejemplos • Preguntas frecuentes • Privacidad • Contribuciones • Licencia

🤔 ¿Qué es GitMCP?

¡Deja de alucinar y empieza a programar con vibraciones!

GitMCP es un servidor gratuito, de código abierto y remoto del Protocolo de Contexto de Modelo (MCP) que transforma cualquier proyecto de GitHub (repositorios o páginas de GitHub) en un centro de documentación. Permite que herramientas de IA como Cursor accedan a documentación y código actualizados, incluso si el LLM nunca los ha visto, eliminando así las alucinaciones de código sin problemas.

GitMCP admite dos variantes -

Repositorio específico (gitmcp.io/{owner}/{repo} o {owner}.gitmcp.io/{repo}): Úsalos cuando trabajes principalmente con un número selecto de bibliotecas. Esto asegura que tu asistente de IA siempre apunte al proyecto correcto, mejorando la seguridad y la relevancia al evitar el acceso a repositorios no deseados.
Servidor genérico (gitmcp.io/docs): Úsalo para máxima flexibilidad cuando necesites cambiar entre diferentes repositorios con frecuencia. El asistente de IA te preguntará (o decidirá según el contexto) a qué repositorio acceder para cada solicitud. Ten en cuenta que esto depende de identificar correctamente el repositorio objetivo cada vez.

Con GitMCP:

Los asistentes de IA acceden a la documentación y el código más recientes directamente desde la fuente.
Obtén un uso preciso de la API y ejemplos de código fiables.
Trabaja eficazmente incluso con bibliotecas especializadas, nuevas o que cambian rápidamente.
Reducción significativa de alucinaciones y mejora de la corrección del código.

Por ejemplo, esta comparación lado a lado muestra el resultado para el mismo prompt de una sola vez en Cursor al crear una escena de three.js -

https://github.com/user-attachments/assets/fbf1b4a7-f9f0-4c0e-831c-4d64faae2c45

✨ Características

😎 Documentación más reciente en CUALQUIER proyecto de GitHub: Otorga a tu asistente de IA acceso sin problemas a la documentación y el código del proyecto de GitHub. Las capacidades integradas de búsqueda inteligente ayudan a encontrar exactamente lo que la IA necesita sin usar demasiados tokens.
🧠 No más alucinaciones: Con GitMCP, tu asistente de IA puede proporcionar respuestas precisas y relevantes a tus preguntas.
☁️ Configuración cero: GitMCP se ejecuta en la nube. Simplemente agrega la URL de GitMCP elegida como servidor MCP en tu IDE — no se requieren descargas, instalaciones, registros ni cambios.
💬 Chat integrado: ¡Comienza rápidamente chateando directamente con la documentación del repositorio a través de nuestro chat en el navegador!
✅ Abierto, gratuito y privado: GitMCP es de código abierto y completamente gratuito. No recopila información personal ni almacena consultas. ¡Incluso puedes autoalojarlo!

🚀 Primeros pasos

¡Usar GitMCP es fácil! Simplemente sigue estos pasos:

Paso 1: Elige el tipo de servidor que deseas

Elige uno de estos formatos de URL según a lo que quieras conectarte:

Para repositorios de GitHub: gitmcp.io/{owner}/{repo}
Para sitios de GitHub Pages: {owner}.gitmcp.io/{repo}
Para una herramienta genérica que admita cualquier repositorio (dinámico): gitmcp.io/docs

Reemplaza {owner} con el nombre de usuario u organización de GitHub, y {repo} con el nombre del repositorio.

Para tu comodidad, también puedes usar la herramienta de conversión en la página de inicio para formatear la URL de GitHub en una URL MCP.

Paso 2: Conecta tu asistente de IA

Selecciona tu asistente de IA de las opciones a continuación y sigue las instrucciones de configuración:

Conectando Cursor

Actualiza tu archivo de configuración de Cursor en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Conectando Claude Desktop

En Claude Desktop, ve a Configuración > Desarrollador > Editar configuración

Reemplaza la configuración con:

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

Conectando Windsurf

Actualiza tu archivo de configuración de Windsurf en ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gitmcp": {
      "serverUrl": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Conectando VSCode

Actualiza tu archivo de configuración de VSCode en .vscode/mcp.json:

{
  "servers": {
    "gitmcp": {
      "type": "sse",
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Conectando Cline

Actualiza tu archivo de configuración de Cline en ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Conectando Highlight AI

Abre Highlight AI y haz clic en el icono de complementos (símbolo @) en la barra lateral
Haz clic en Complementos instalados en la parte superior de la barra lateral
Selecciona Complemento personalizado
Haz clic en Agregar un complemento usando una URL SSE personalizada

Nombre del complemento: gitmcp URL SSE: https://gitmcp.io/{owner}/{repo}

Para más detalles sobre cómo agregar servidores MCP personalizados a HighlightAI, consulta la documentación.

Conectando Augment Code

Abre la configuración de Augment Code
Navega a la sección MCP
Agrega un nuevo servidor MCP con los siguientes detalles:

Nombra el servidor MCP: git-mcp Docs

Usa este comando:

npx mcp-remote https://gitmcp.io/{owner}/{repo}

O usa la siguiente configuración:

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

Conectando Msty AI

Abre Msty Studio
Ve a Herramientas > Importar herramientas desde el portapapeles JSON
Pega la siguiente configuración:

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

Para más detalles sobre cómo configurar servidores MCP en Augment Code, visita la documentación de Augment Code.

Nota: Recuerda reemplazar {owner} y {repo} con el nombre de usuario/organización y el nombre del repositorio reales de GitHub. También puedes usar el endpoint dinámico https://gitmcp.io/docs para permitir que tu IA acceda a cualquier repositorio bajo demanda.

⚙ Cómo funciona

GitMCP conecta tu asistente de IA a repositorios de GitHub usando el Protocolo de Contexto de Modelo (MCP), un estándar que permite a las herramientas de IA solicitar información adicional de fuentes externas.

Qué sucede cuando usas GitMCP:

Proporcionas la URL de GitMCP a tu asistente de IA (por ejemplo, gitmcp.io/microsoft/typescript). GitMCP expone herramientas como obtención de documentación, búsqueda inteligente, búsqueda de código, etc.
Pregunta al asistente de IA sobre cuestiones relacionadas con documentación/código.
Tu IA envía solicitudes a GitMCP para usar sus herramientas (con tu aprobación).
GitMCP ejecuta la solicitud de la IA y devuelve los datos solicitados.
Tu IA recibe la información y genera una respuesta más precisa y fundamentada sin alucinaciones.

Documentación admitida

GitMCP actualmente admite los siguientes documentos (en orden de prioridad):

llms.txt
Versión optimizada para IA de la documentación del proyecto
README.md/root

💡 Ejemplos

Aquí hay algunos ejemplos de cómo usar GitMCP con diferentes asistentes de IA y repositorios:

Ejemplo 1: Usando Windsurf con un repositorio específico

Para el repositorio de GitHub https://github.com/microsoft/playwright-mcp, agrega https://gitmcp.io/microsoft/playwright-mcp como servidor MCP a Windsurf.

Prompt para Claude:

"¿Cómo uso el MCP de Playwright?"

Windsurf extraerá la documentación relevante de GitMCP para implementar la función de memoria correctamente.

Ejemplo 2: Usando Cursor con un sitio de GitHub Pages

Para el sitio de GitHub Pages langchain-ai.github.io/langgraph, agrega https://langchain-ai.gitmcp.io/langgraph como servidor MCP a Cursor.

Prompt para Cursor:

"Agrega memoria a mi agente LangGraph"

Cursor extraerá la documentación y el código relevantes de GitMCP para implementar correctamente la función de memoria.

Ejemplo 3: Usando Claude Desktop con el endpoint dinámico

No tienes que elegir repositorios específicos. El endpoint genérico gitmcp.io/docs permite que la IA elija el proyecto de GitHub sobre la marcha.

Prompt para cualquier asistente de IA:

"Quiero aprender sobre el modelo de reconocimiento de voz OpenAI Whisper. Explica cómo funciona."

Claude extraerá los datos de GitMCP y responderá la pregunta.

🛠️ Herramientas

GitMCP proporciona a los asistentes de IA varias herramientas valiosas para ayudarlos a acceder, comprender y consultar repositorios de GitHub.

`fetch_<repo-name>_documentation`

Esta herramienta obtiene la documentación principal de un repositorio de GitHub. Funciona recuperando documentación relevante (por ejemplo, llms.txt). Esto le da a la IA una buena visión general de qué trata el proyecto.

Cuándo es útil: Para preguntas generales sobre el propósito, las características o cómo comenzar de un proyecto.

`search_<repo-name>_documentation`

Esta herramienta permite a la IA buscar en la documentación de un repositorio proporcionando una consulta de búsqueda específica. En lugar de cargar toda la documentación (que podría ser muy grande), utiliza búsqueda inteligente para encontrar solo las partes relevantes.

Cuándo es útil: Para preguntas específicas sobre características, funciones o conceptos particulares dentro de un proyecto.

`fetch_url_content`

Esta herramienta ayuda a la IA a obtener información de enlaces mencionados en la documentación. Recupera el contenido de esos enlaces y lo convierte a un formato que la IA puede leer fácilmente.

Cuándo es útil: Cuando la documentación hace referencia a información externa que ayudaría a responder tu pregunta.

`search_<repo-name>_code`

Esta herramienta busca en el código real del repositorio usando la búsqueda de código de GitHub. Ayuda a la IA a encontrar ejemplos de código específicos o detalles de implementación.

Cuándo es útil: Cuando quieres ejemplos de cómo se implementa algo o necesitas detalles técnicos no cubiertos en la documentación.

Nota: Al usar el endpoint dinámico (gitmcp.io/docs), estas herramientas se nombran de manera ligeramente diferente (fetch_generic_documentation, search_generic_code y search_generic_documentation) y necesitan información adicional sobre a qué repositorio acceder.

📊 Insignia

GitMCP tiene una insignia para el README de tu repositorio. Permite a los usuarios acceder rápidamente a tu documentación a través de su IDE o navegador (usando el chat integrado). También muestra cuántas veces se ha accedido a tu documentación a través de GitMCP.

Ejemplo (idosal/git-mcp):

Agregar la insignia a tu repositorio

Agrega lo siguiente a tu README.md:

[![GitMCP](https://img.shields.io/endpoint?url=https://gitmcp.io/badge/OWNER/REPO)](https://gitmcp.io/OWNER/REPO)

Reemplaza OWNER con tu nombre de usuario u organización de GitHub, y REPO con el nombre de tu repositorio.

Cómo contamos las vistas

Incremento por cada llamada a herramienta en el repositorio específico.

Personalizando la insignia

Puedes personalizar la apariencia de la insignia con parámetros:

Parámetro	Descripción	Predeterminado	Ejemplo
`color`	Color para el valor de la insignia	`aquamarine`	`?color=green`
`label`	Etiqueta de la insignia	`GitMCP`	`Documentation`

¡Contáctanos si necesitas ayuda!

❓ Preguntas frecuentes

¿Qué es el Protocolo de Contexto de Modelo?

El Protocolo de Contexto de Modelo es un estándar que permite a los asistentes de IA solicitar y recibir contexto adicional de fuentes externas de manera estructurada, mejorando su comprensión y rendimiento.

¿GitMCP funciona con cualquier asistente de IA?

Sí, GitMCP es compatible con cualquier asistente de IA que admita el Protocolo de Contexto de Modelo, incluyendo herramientas como Cursor, VSCode, Claude, etc.

¿GitMCP es compatible con todos los proyectos de GitHub?

¡Absolutamente! GitMCP funciona con cualquier repositorio público de GitHub sin requerir modificaciones. Prioriza el archivo llms.txt y recurre a README.md u otras páginas si el primero no está disponible. Las actualizaciones futuras tienen como objetivo admitir métodos de documentación adicionales e incluso generar contenido dinámicamente.

¿GitMCP cuesta dinero?

No, GitMCP es un servicio gratuito para la comunidad sin costos asociados.

🔒 Privacidad

GitMCP está profundamente comprometido con la privacidad de sus usuarios. El servicio no tiene acceso ni almacena información personal identificable, ya que no requiere autenticación. Además, no almacena ninguna consulta enviada por los agentes. Además, como GitMCP es un proyecto de código abierto, puede implementarse de forma independiente en tu entorno. GitMCP solo accede a contenido que ya está disponible públicamente y solo cuando un usuario lo consulta. GitMCP no rastrea repositorios automáticamente. Antes de acceder a cualquier sitio de GitHub Pages, el código verifica las reglas de robots.txt y sigue las directrices establecidas por los propietarios del sitio, permitiéndoles optar por no participar. Ten en cuenta que GitMCP no almacena permanentemente datos sobre los proyectos de GitHub ni su contenido.

👥 Contribuciones

¡Damos la bienvenida a contribuciones, comentarios e ideas! Por favor, revisa nuestras pautas de contribución.

Configuración de desarrollo local

Clona el repositorio

git clone https://github.com/idosal/git-mcp.git
cd git-mcp

Instala las dependencias
```
pnpm install
```
Ejecuta localmente para desarrollo
```
npm run dev
# or
pnpm dev
```

Uso de MCP Inspector para pruebas

Instala la herramienta MCP Inspector:
```
npx @modelcontextprotocol/inspector
```
En la interfaz del inspector:
- Establece el tipo de transporte a SSE
- Ingresa tu URL de GitMCP (p. ej., http://localhost:5173/docs)
- Haz clic en "Conectar"

📄 Licencia

Este proyecto está licenciado bajo la Apache License 2.0.

Descargo de responsabilidad

GitMCP se proporciona "tal cual" sin garantía de ningún tipo. Si bien nos esforzamos por garantizar la confiabilidad y seguridad de nuestro servicio, no somos responsables de ningún daño o problema que pueda surgir de su uso. Los proyectos de GitHub a los que se accede a través de GitMCP están sujetos a los términos y condiciones de sus respectivos propietarios. GitMCP no está afiliado a GitHub ni a ninguna de las herramientas de IA mencionadas.

GitMCP

Documentación

GitMCP

🤔 ¿Qué es GitMCP?

✨ Características

🚀 Primeros pasos

Paso 1: Elige el tipo de servidor que deseas

Paso 2: Conecta tu asistente de IA

Conectando Cursor

Conectando Claude Desktop

Conectando Windsurf

Conectando VSCode

Conectando Cline

Conectando Highlight AI

Conectando Augment Code

Conectando Msty AI

⚙ Cómo funciona

Documentación admitida

💡 Ejemplos

Ejemplo 1: Usando Windsurf con un repositorio específico

Ejemplo 2: Usando Cursor con un sitio de GitHub Pages

Ejemplo 3: Usando Claude Desktop con el endpoint dinámico

🛠️ Herramientas

fetch_<repo-name>_documentation

search_<repo-name>_documentation

fetch_url_content

search_<repo-name>_code

📊 Insignia

Agregar la insignia a tu repositorio

Cómo contamos las vistas

Personalizando la insignia

❓ Preguntas frecuentes

¿Qué es el Protocolo de Contexto de Modelo?

¿GitMCP funciona con cualquier asistente de IA?

¿GitMCP es compatible con todos los proyectos de GitHub?

¿GitMCP cuesta dinero?

🔒 Privacidad

👥 Contribuciones

Configuración de desarrollo local

Uso de MCP Inspector para pruebas

📄 Licencia

Descargo de responsabilidad

Historial de estrellas

`fetch_<repo-name>_documentation`

`search_<repo-name>_documentation`

`fetch_url_content`

`search_<repo-name>_code`