OSSInsight

Analiza repositorios, desarrolladores y organizaciones de GitHub con datos de OSSInsight.io.

Documentación

Servidor MCP de OSSInsight

Un servidor MCP basado en OSSInsight.io, que proporciona análisis de datos para individuos, organizaciones y repositorios de GitHub, así como información profunda sobre el ecosistema de código abierto.

Características

Análisis de repositorios: Obtén datos completos sobre repositorios de GitHub, incluyendo tendencias de estrellas, actividad de contribuyentes y commits de código
Análisis de desarrolladores: Comprende los patrones de contribución, historial de actividad e influencia de los desarrolladores
Análisis de organizaciones: Visualiza una perspectiva global de las organizaciones de GitHub, incluyendo miembros, repositorios y actividad general
Comparación de proyectos: Compara métricas clave entre dos repositorios lado a lado para descubrir diferencias y similitudes
Colecciones de proyectos: Explora y navega colecciones seleccionadas de proyectos, como bases de datos de código abierto, herramientas de IA, etc.
Consultas en lenguaje natural: Accede a la interfaz de chat de OSSInsight para hacer preguntas sobre datos de GitHub

Herramientas

get_repo_analysis
- Obtén un análisis detallado de un repositorio de GitHub
- Entrada:
  - owner_repo (cadena): Nombre del repositorio en el formato 'owner/repo'
  - time_period (cadena opcional): Rango de tiempo para el análisis
- Devuelve: Datos de análisis del repositorio tanto de la API como de la página web, con un enlace a la página de OSSInsight
get_developer_analysis
- Obtén un análisis detallado de un desarrollador de GitHub
- Entrada:
  - username (cadena): Nombre de usuario de GitHub
- Devuelve: Datos del desarrollador tanto de la API como de la página web, con un enlace a la página de OSSInsight
get_collection
- Obtén información sobre una colección específica de repositorios
- Entrada:
  - collection_id (cadena): ID de la colección, por ejemplo, 'open-source-database'
- Devuelve: Datos de la colección y un enlace a la página de la colección en OSSInsight
list_collections
- Lista todas las colecciones de repositorios disponibles
- Entrada:
  - page (número opcional): Número de página, comenzando desde 1
  - per_page (número opcional): Número de resultados por página, el valor predeterminado es 20
- Devuelve: Lista de colecciones y un enlace para explorar colecciones en OSSInsight
natural_language_query
- Acceso directo a la interfaz de consulta en lenguaje natural de OSSInsight
- Entrada:
  - query (cadena): Consulta en lenguaje natural, por ejemplo, '¿Qué repositorios ganaron más estrellas en 2023?'
- Devuelve: Un enlace directo a la interfaz de chat de OSSInsight con la consulta prellenada

Detalles de implementación

Este servidor MCP utiliza un enfoque dual para recuperar datos:

API pública de OSSInsight (v1) - Realiza llamadas directas a los endpoints de https://api.ossinsight.io/v1/
Extracción de páginas web - Recurre a la extracción de las páginas web de OSSInsight cuando las API están limitadas o no están disponibles

Este enfoque garantiza la máxima cobertura de las funciones de OSSInsight mientras respeta los límites de velocidad de la API pública (600 solicitudes por hora por IP).

Configuración

Configuración de uso

Docker

{
  "mcpServers": { 
    "ossinsight": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/ossinsight"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "ossinsight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ossinsight"
      ]
    }
  }
}

Compilación

Compilación de Docker:

docker build -t mcp/ossinsight -f Dockerfile .

Ejemplos

Obtener análisis de repositorio

// Get analysis data for the VSCode repository
{
  "owner_repo": "microsoft/vscode"
}

Comparar dos repositorios

// Compare React and Vue
{
  "repo1": "facebook/react",
  "repo2": "vuejs/vue"
}

Consulta en lenguaje natural

// Get a link to query data using natural language
{
  "query": "Which database projects gained the most stars in 2023?"
}

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que puedes usar, modificar y distribuir libremente este software, sujeto a los términos y condiciones de la Licencia MIT. Consulta el archivo LICENSE en el repositorio del proyecto para más detalles.