GitHub Trending

Servidor MCP mcp-github-trending

Um servidor MCP que fornece acesso a dados de repositórios e desenvolvedores em alta no GitHub por meio de uma interface de API simples.

Recursos

• Acessa dados de repositórios e desenvolvedores em alta no GitHub
• Filtra por linguagem de programação
• Filtra por período de tempo (diário, semanal, mensal)
• Filtra por idioma falado
• Retorna respostas JSON bem formatadas

Ferramentas

O servidor implementa as seguintes ferramentas:

get_github_trending_repositories

Obtém repositórios em alta do GitHub com os seguintes parâmetros:

• language (opcional): Linguagem de programação para filtrar repositórios (ex.: "python", "javascript")
• since (opcional): Período de tempo para filtrar repositórios ("daily", "weekly", "monthly"). O padrão é "daily"
• spoken_language (opcional): Idioma falado para filtrar repositórios

Exemplo de resposta:

[
  {
    "name": "repository-name",
    "fullname": "owner/repository-name",
    "url": "https://github.com/owner/repository-name",
    "description": "Repository description",
    "language": "Python",
    "stars": 1000,
    "forks": 100,
    "current_period_stars": 50
  }
]

get_github_trending_developers

Obtém desenvolvedores em alta do GitHub com os seguintes parâmetros:

• language (opcional): Linguagem de programação para filtrar (ex.: "python", "javascript")
• since (opcional): Período de tempo para filtrar ("daily", "weekly", "monthly"). O padrão é "daily"

Exemplo de resposta:

[
  {
    "username": "developer",
    "name": "Developer Name",
    "url": "https://github.com/developer",
    "avatar": "https://avatars.githubusercontent.com/u/123456",
    "repo": {
      "name": "repository-name",
      "description": "Repository description",
      "url": "https://github.com/developer/repository-name"
    }
  }
]

Instalação

Pré-requisitos

• Python 3.12

Etapas de Instalação

Instale o pacote:

pip install mcp-github-trending

Configuração do Claude Desktop

No MacOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

No Windows:

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-github-trending": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-github-trending",
        "run",
        "mcp-github-trending"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-github-trending": {
      "command": "uvx",
      "args": [
        "mcp-github-trending"
      ]
    }
  }
}

Desenvolvimento

Construção e Publicação

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Construa as distribuições do pacote:

uv build

3. Publique no PyPI:

uv publish

Observação: Defina as credenciais do PyPI por meio de variáveis de ambiente ou sinalizadores de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Para a melhor experiência de depuração, use o MCP Inspector.

Inicie o MCP Inspector via npm:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-github-trending run mcp-github-trending

O Inspector exibirá uma URL que você pode acessar no navegador para começar a depurar.

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.