GitMCP

GitMCP

🤔 ¿Qué es GitMCP?

¡Deja de alucinar vibracionalmente y comienza a codificar vibracionalmente!

GitMCP es un servidor remoto de Protocolo de Contexto de Modelo (MCP) gratuito y de código abierto 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} ): Úselo cuando trabaje principalmente con un número limitado de bibliotecas. Esto garantiza que su asistente de IA siempre se dirija al proyecto correcto, lo que mejora la seguridad y la relevancia al evitar el acceso a repositorios no deseados.
• Servidor genérico ( gitmcp.io/docs ): Úselo para máxima flexibilidad cuando necesite cambiar entre repositorios con frecuencia. El asistente de IA le indicará (o decidirá según el contexto) a qué repositorio acceder en cada solicitud. Tenga en cuenta que esto depende de la correcta identificación del repositorio de destino en cada ocasión.

Con GitMCP:

• Los asistentes de IA acceden a la documentación y al código más recientes directamente desde la fuente.
• Obtenga un uso preciso de la API y ejemplos de código confiables.
• Trabaje eficazmente incluso con bibliotecas especializadas, nuevas o que cambian rápidamente.
• Se redujeron significativamente las alucinaciones y se mejoró la corrección del código.

Por ejemplo, esta comparación lado a lado muestra el resultado para el mismo mensaje único en Cursor al crear una escena three.js -

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

✨ Características

• Documentación actualizada de cualquier proyecto de GitHub : Dale a tu asistente de IA acceso sin problemas a la documentación y el código del proyecto de GitHub. Las funciones de búsqueda inteligente integradas ayudan a encontrar exactamente lo que la IA necesita sin usar demasiados tokens.
• 🧠 No más alucinaciones : con GitMCP, su asistente de IA puede proporcionar respuestas precisas y relevantes a sus preguntas.
• ☁️ Sin configuración : GitMCP se ejecuta en la nube. Simplemente añade la URL de GitMCP elegida como servidor MCP en tu IDE; no se requieren descargas, instalaciones, registros ni cambios.
• 💬 Chat integrado : ¡comience rápidamente a chatear 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 alojarlo tú mismo!

🚀 Primeros pasos

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

Paso 1: Elige el tipo de servidor que deseas

Elija uno de estos formatos de URL según a qué desee conectarse:

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

Reemplace {owner} con el nombre de usuario de GitHub o el nombre de la organización, y {repo} con el nombre del repositorio.

Para su comodidad, también puede utilizar la herramienta de conversión en la página de destino para formatear la URL de GitHub en una URL de MCP.

Paso 2: Conecta tu asistente de IA

Seleccione su asistente de IA de las opciones a continuación y siga las instrucciones de configuración:

Conectando el cursor

Actualice el archivo de configuración del cursor en ~/.cursor/mcp.json :

Conectando Claude Desktop

1. En Claude Desktop, vaya a Configuración > Desarrollador > Editar configuración
2. Reemplace la configuración con:
   { "mcpServers": { "gitmcp": { "command": "npx", "args": [ "mcp-remote", "https://gitmcp.io/{owner}/{repo}" ] } } }

Conectando Windsurf

Actualice su archivo de configuración de Windsurf en ~/.codeium/windsurf/mcp_config.json :

Conectando VSCode

Actualice su archivo de configuración de VSCode en .vscode/mcp.json :

Conectando Cline

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

Conexión de Highlight AI

1. Abra Highlight AI y haga clic en el ícono de complementos (símbolo @) en la barra lateral
2. Haga clic en Complementos instalados en la parte superior de la barra lateral
3. Seleccionar complemento personalizado
4. Haga clic en Agregar un complemento usando una URL SSE personalizada

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

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

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

⚙ Cómo funciona

GitMCP conecta su asistente de IA a los repositorios de GitHub mediante 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?

1. Proporciona la URL de GitMCP a tu asistente de IA (p. ej., gitmcp.io/microsoft/typescript ). GitMCP expone herramientas como la obtención de documentación, la búsqueda inteligente, la búsqueda de código, etc.
2. Proporcione indicaciones al asistente de IA sobre preguntas relacionadas con la documentación o el código.
3. Su IA envía solicitudes a GitMCP para utilizar sus herramientas (con su aprobación).
4. GitMCP ejecuta la solicitud de la IA y devuelve los datos solicitados.
5. Su IA recibe la información y genera una respuesta más precisa y fundamentada, sin alucinaciones.

Documentación de apoyo

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

1. llms.txt
2. Versión optimizada con IA de la documentación del proyecto
3. README.md /root

💡 Ejemplos

A continuación se muestran algunos ejemplos de cómo utilizar GitMCP con diferentes asistentes de IA y repositorios:

Ejemplo 1: Uso de Windsurf con un repositorio específico

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

Aviso a Claude:

¿Cómo se utiliza el Playwright MCP?

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

Ejemplo 2: Uso de Cursor con un sitio de GitHub Pages

Para el sitio de páginas de GitHub langchain-ai.github.io/langgraph , agregue https://langchain-ai.gitmcp.io/langgraph como servidor MCP a Cursor.

Aviso al cursor:

"Añadir 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: Uso de Claude Desktop con el punto final dinámico

No tienes que seleccionar repositorios específicos. El punto de acceso genérico gitmcp.io/docs permite que la IA seleccione el proyecto de GitHub al instante.

Mensaje a cualquier asistente de IA:

Quiero aprender sobre el modelo de reconocimiento de voz OpenAI Whisper. Explícame 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 los repositorios de GitHub.

fetch_<repo-name>_documentation

Esta herramienta obtiene la documentación principal de un repositorio de GitHub. Funciona recuperando documentación relevante (p. ej., llms.txt ). Esto proporciona a la IA una buena visión general del proyecto.

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

search_<repo-name>_documentation

Esta herramienta permite a la IA buscar en la documentación de un repositorio mediante una consulta específica. En lugar de cargar toda la documentación (que podría ser muy extensa), utiliza la 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 los enlaces mencionados en la documentación. Recupera el contenido de esos enlaces y lo convierte a un formato fácil de leer para la IA.

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

search_<repo-name>_code

Esta herramienta busca en el código del repositorio mediante 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 desea ejemplos de cómo se implementa algo o necesita detalles técnicos que no están cubiertos en la documentación

Nota: Al utilizar el punto final dinámico ( gitmcp.io/docs ), estas herramientas tienen nombres ligeramente diferentes ( 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 en el README de tu repositorio. Esto 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 ):

Cómo agregar la insignia a su repositorio

Añade lo siguiente a tu README.md :

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

Cómo contamos las visualizaciones

Incremento para cada llamada de herramienta en el repositorio específico.

Personalización de la insignia

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

¡Por favor contacte con nosotros!

❓ Preguntas frecuentes

¿Qué es el Protocolo de Contexto Modelo?

El Protocolo de Contexto 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 desempeño.

¿GitMCP funciona con cualquier asistente de IA?

Sí, GitMCP es compatible con cualquier asistente de IA que admita el Protocolo de contexto de modelo, incluidas herramientas como Cursor, VSCode, Claude, etc.

¿GitMCP es compatible con todos los proyectos de GitHub?

¡Por supuesto! GitMCP funciona con cualquier repositorio público de GitHub sin necesidad de modificaciones. Prioriza el archivo llms.txt y recurre a README.md u otras páginas si el primero no está disponible. Las futuras actualizaciones buscan 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 las consultas enviadas por los agentes. Además, al ser GitMCP un proyecto de código abierto, puede implementarse de forma independiente en su entorno.

GitMCP solo accede al contenido público cuando lo consulta un usuario. GitMCP no extrae automáticamente los repositorios. Antes de acceder a cualquier sitio de GitHub Pages, el código comprueba las reglas de robots.txt y sigue las directivas establecidas por los propietarios del sitio, permitiéndoles optar por no participar. Tenga en cuenta que GitMCP no almacena permanentemente datos sobre los proyectos de GitHub ni su contenido.

👥 Contribuyendo

Agradecemos sus contribuciones, comentarios e ideas. Por favor, revise nuestras normas de contribución .

Configuración de desarrollo local

1. Clonar el repositorio
   git clone https://github.com/idosal/git-mcp.git cd git-mcp
2. Instalar dependencias
   pnpm install
3. Ejecutar localmente para el desarrollo
   npm run dev # or pnpm dev

Uso de MCP Inspector para realizar pruebas

1. Instalar la herramienta MCP Inspector:
   npx @modelcontextprotocol/inspector
2. En la interfaz del inspector:
   • Establecer el tipo de transporte en SSE
   • Ingrese su URL de GitMCP (por ejemplo, http://localhost:5173/docs )
   • Haga clic en "Conectar"

📄 Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0 .

Descargo de responsabilidad

GitMCP se proporciona "tal cual", sin garantía de ningún tipo. Si bien nos esforzamos por garantizar la fiabilidad y seguridad de nuestro servicio, no nos responsabilizamos 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.

Historia de las estrellas