GitHub Trending

Servidor MCP mcp-github-trending

Un servidor MCP que proporciona acceso a los repositorios y desarrolladores en tendencia de GitHub a través de una interfaz API simple.

Características

• Acceso a datos de repositorios y desarrolladores en tendencia de GitHub
• Filtrar por lenguaje de programación
• Filtrar por período de tiempo (diario, semanal, mensual)
• Filtrar por idioma hablado
• Devuelve respuestas JSON bien formateadas

Herramientas

El servidor implementa las siguientes herramientas:

get_github_trending_repositories

Obtiene repositorios en tendencia de GitHub con los siguientes parámetros:

• language (opcional): Lenguaje de programación para filtrar repositorios (ej. "python", "javascript")
• since (opcional): Período de tiempo para filtrar repositorios ("daily", "weekly", "monthly"). Por defecto es "daily"
• spoken_language (opcional): Idioma hablado para filtrar repositorios

Ejemplo de respuesta:

[
  {
    "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

Obtiene desarrolladores en tendencia de GitHub con los siguientes parámetros:

• language (opcional): Lenguaje de programación para filtrar (ej. "python", "javascript")
• since (opcional): Período de tiempo para filtrar ("daily", "weekly", "monthly"). Por defecto es "daily"

Ejemplo de respuesta:

[
  {
    "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"
    }
  }
]

Instalación

Requisitos previos

• Python 3.12

Pasos de instalación

Instale el paquete:

pip install mcp-github-trending

Configuración de Claude Desktop

En MacOS:

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

En 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"
      ]
    }
  }
}

Desarrollo

Compilación y Publicación

1. Sincronice las dependencias y actualice el archivo de bloqueo:

uv sync

2. Compile las distribuciones del paquete:

uv build

3. Publique en PyPI:

uv publish

Nota: Establezca las credenciales de PyPI mediante variables de entorno o banderas de comando:

• Token: --token o UV_PUBLISH_TOKEN
• Usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Para una mejor experiencia de depuración, use el Inspector MCP.

Inicie el Inspector MCP a través de npm:

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

El Inspector mostrará una URL que puede acceder en su navegador para comenzar a depurar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENCIA para más detalles.