OSSInsight

Analise repositórios, desenvolvedores e organizações do GitHub com dados do OSSInsight.io.

Documentação

Servidor MCP OSSInsight

Um servidor MCP baseado no OSSInsight.io, que fornece análise de dados para indivíduos, organizações e repositórios do GitHub, bem como insights aprofundados sobre o ecossistema de código aberto.

Recursos

Análise de Repositórios: Obtenha dados abrangentes sobre repositórios do GitHub, incluindo tendências de estrelas, atividade de contribuidores e commits de código
Análise de Desenvolvedores: Entenda os padrões de contribuição, histórico de atividades e influência dos desenvolvedores
Análise de Organizações: Veja uma perspectiva global das organizações do GitHub, incluindo membros, repositórios e atividade geral
Comparação de Projetos: Compare métricas-chave entre dois repositórios lado a lado para descobrir diferenças e semelhanças
Coleções de Projetos: Navegue e explore coleções selecionadas de projetos, como bancos de dados de código aberto, ferramentas de IA, etc.
Consultas em Linguagem Natural: Acesse a interface de chat do OSSInsight para fazer perguntas sobre dados do GitHub

Ferramentas

get_repo_analysis
- Obtenha uma análise detalhada de um repositório do GitHub
- Entrada:
  - owner_repo (string): Nome do repositório no formato 'owner/repo'
  - time_period (string opcional): Intervalo de tempo para análise
- Retorna: Dados de análise do repositório da API e da página web, com um link para a página do OSSInsight
get_developer_analysis
- Obtenha uma análise detalhada de um desenvolvedor do GitHub
- Entrada:
  - username (string): Nome de usuário do GitHub
- Retorna: Dados do desenvolvedor da API e da página web, com um link para a página do OSSInsight
get_collection
- Obtenha informações sobre uma coleção específica de repositórios
- Entrada:
  - collection_id (string): ID da coleção, ex.: 'open-source-database'
- Retorna: Dados da coleção e um link para a página da coleção no OSSInsight
list_collections
- Liste todas as coleções de repositórios disponíveis
- Entrada:
  - page (número opcional): Número da página, começando em 1
  - per_page (número opcional): Número de resultados por página, o padrão é 20
- Retorna: Lista de coleções e um link para navegar pelas coleções no OSSInsight
natural_language_query
- Acesso direto à interface de consulta em linguagem natural do OSSInsight
- Entrada:
  - query (string): Consulta em linguagem natural, ex.: 'Which repositories gained the most stars in 2023?'
- Retorna: Um link direto para a interface de chat do OSSInsight com a consulta pré-preenchida

Detalhes de Implementação

Este servidor MCP usa uma abordagem dupla para recuperar dados:

API Pública do OSSInsight (v1) - Faz chamadas diretas à API para os endpoints https://api.ossinsight.io/v1/
Raspagem de Páginas Web - Recorre à raspagem das páginas web do OSSInsight quando as APIs estão limitadas ou indisponíveis

Essa abordagem garante a cobertura máxima dos recursos do OSSInsight, respeitando os limites de taxa da API pública (600 solicitações por hora por IP).

Configuração

Configuração de Uso

Docker

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

NPX

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

Build

Build do Docker:

docker build -t mcp/ossinsight -f Dockerfile .

Exemplos

Obter Análise de Repositório

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

Comparar Dois Repositórios

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

Consulta em Linguagem Natural

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

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você pode usar, modificar e distribuir este software livremente, sujeito aos termos e condições da Licença MIT. Consulte o arquivo LICENSE no repositório do projeto para obter detalhes.