GitHunt

githunt-mcp

Un servidor MCP que le da a tu asistente de IA una vista de reclutador de GitHub. Envuelve la API de GitHunt's para que Claude, Cursor y otros clientes MCP puedan buscar en un grupo preindexado de desarrolladores de GitHub, consultar un perfil clasificado y ejecutar un análisis profundo de IA sobre un candidato - todo desde un mensaje de chat.

Pregunta "encuentra ingenieros backend en Berlín que sepan Go y Kubernetes" y obtén una lista corta clasificada y puntuada con señales de actividad e información de contacto.

¿Prefieres configuración cero? GitHunt también ejecuta un servidor MCP alojado en https://mcp.githunt.ai/mcp. Añádelo como conector personalizado en Claude (Settings -> Connectors) o como servidor MCP remoto en tu cliente e inicia sesión con tu cuenta de GitHunt - no se necesita clave API ni proceso local. Este paquete es la alternativa autoalojada (stdio).

Inicio rápido

1. Obtén una clave API de tu cuenta de GitHunt.

2. Ejecuta el servidor:

   GITHUNT_API_KEY=your-key-here npx githunt-mcp
   

3. Conéctalo a tu cliente (ver más abajo) y luego simplemente pregunta.

Variables de entorno

Variable	Requerido	Descripción
GITHUNT_API_KEY	sí	Tu clave API de GitHunt
GITHUNT_API_URL	no	URL base de la API (por defecto https://api.githunt.ai)

Claude Code

claude mcp add githunt -e GITHUNT_API_KEY=your-key-here -- npx githunt-mcp

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Cualquier cliente MCP que hable stdio funciona de la misma manera: ejecuta npx githunt-mcp con GITHUNT_API_KEY en el entorno.

Pruébalo

Una vez conectado, pregunta a tu asistente de forma natural:

• "Encuentra desarrolladores frontend senior en Varsovia que sepan React y TypeScript."
• "Muéstrame ingenieros DevOps contratables en Polonia con más de 5 años en GitHub."
• "Dame los siguientes 25 candidatos para esa búsqueda." (paginación mediante offset)
• "Abre el perfil de GitHunt de octocat."
• "Haz un análisis profundo de torvalds - nivel de competencia, roles más adecuados, cualquier correo público."
• "Busca ingenieros de ML en San Francisco, luego analiza tus 3 mejores."

Herramientas

Herramienta	Qué hace	Velocidad
search_developers	Busca en el grupo preindexado de GitHunt por location, role, skills, languages, y más. Devuelve candidatos clasificados por ajuste con puntuaciones, actividad e información de contacto. Pagina mediante offset (0-200). Devuelve una tabla Markdown además de JSON estructurado. Si una ubicación no coincide con nada, sugiere ubicaciones similares admitidas en lugar de una página vacía.	Rápido (servido desde el grupo, sin rastreo en vivo)
get_developer	Obtén el perfil clasificado de un desarrollador por login/username: puntuaciones general, de perfil, de stack tecnológico y de actividad, experiencia, actividad de commits, repos principales e información de contacto.	Rápido (primero caché)
analyze_profile	Análisis profundo de IA de un perfil a partir de datos en vivo de GitHub: nivel de competencia, roles más adecuados y correos extraídos. Úsalo para evaluar a un candidato preseleccionado.	Más lento (rastreo en vivo)

Valores admitidos de role: fullstack, frontend, backend, mobile, devops, ai-engineer, ai-orchestrator, ml-engineer, data-scientist, data-engineer, security, cloud, blockchain, embedded, gamedev, ios-developer, android-developer, sre, platform-engineer, qa-engineer, solutions-architect, cto, vp-engineering, head-engineering, engineering-manager, tech-lead, product-manager, director-engineering.

Las habilidades se emparejan con sinónimos (k8s -> kubernetes), y las ubicaciones se normalizan (SF, NYC, UK, Warszawa).

Referencia completa de la API: https://docs.githunt.ai

Puntuación

Cada candidato lleva una puntuación general construida a partir de tres dimensiones, todas expuestas en get_developer:

• Puntuación de perfil - biografía, señales de seniority y madurez de la cuenta.
• Puntuación de stack tecnológico - qué tan bien coinciden sus lenguajes y repos con las habilidades y el rol solicitados.
• Puntuación de actividad - actualidad y volumen de contribuciones públicas (commits, frecuencia, calidad de los mensajes de commit).

search_developers clasifica el grupo por ajuste a tu consulta; analyze_profile recalcula la competencia y el ajuste del rol con datos frescos de GitHub.

Cuotas

Las solicitudes cuentan contra la cuota de tu plan de GitHunt. Cada respuesta incluye tu uso actual (used / limit del mes), y un error quota_exceeded te indica cuando has alcanzado el límite. Consulta tu cuenta para conocer los límites del plan.

Limitaciones y uso responsable

GitHunt lee actividad pública de GitHub, que es una fuerte evidencia de trabajo técnico pero está lejos de ser el panorama completo:

• Es ciego a contribuciones de repos privados, internos y empresariales: muchos ingenieros excelentes tienen perfiles públicos tranquilos.
• El grupo de candidatos está preindexado, por lo que las cuentas nuevas o poco activas pueden faltar; analyze_profile obtiene datos en vivo para una persona específica.
• Las señales de actividad pública pueden sesgarse por geografía, empleador y etapa profesional.

Úsalo como un generador de leads, no como un filtro automático. Trata las puntuaciones como un punto de partida para una conversación humana, no como una decisión de contratación. GitHub no es el ingeniero completo.

Contribuciones

Los issues y pull requests son bienvenidos. Por favor abre un issue describiendo el cambio antes de enviar un PR grande. Para el comportamiento de la API y detalles de endpoints, consulta https://docs.githunt.ai.

Licencia

MIT - consulta LICENSE.