GitHub Trending MCP

Obtiene repositorios populares de GitHub y los guarda como archivos Markdown. Soporta configuración de proxy.

GitHub
1
Prueba este MCPPatrocinado

Documentación

GitHub Trending MCP

Esta es una herramienta de obtención de repositorios populares de GitHub basada en el framework FastMCP, que puede obtener de una sola vez la información detallada de un número opcional de repositorios populares de GitHub del día, incluyendo nombre, enlace, descripción y contenido del README. Así no tendrás que revisar los README uno por uno para resumir blogs, lo que puede ahorrar Tokens de IA.

Características

  • Obtener la lista de repositorios populares de GitHub del día
  • Soporta personalizar la cantidad de repositorios a obtener
  • Soporta configuración de proxy (a través de variables de entorno)
  • Soporta guardar los resultados como archivo Markdown
  • Maneja automáticamente archivos con el mismo nombre, evitando sobrescrituras

Métodos de instalación

Instalación desde el repositorio

# 使用pip从GitHub仓库安装
pip install git+https://github.com/RusianHu/GitHubDailyTrendingFetcher-mcp.git

Instalación local

# 克隆仓库
git clone https://github.com/RusianHu/GitHubDailyTrendingFetcher-mcp.git
cd GitHubDailyTrendingFetcher-mcp

# 安装到本地环境
pip install -e .

Cómo usar

Ejecutar como herramienta de línea de comandos

Después de la instalación, puedes ejecutar directamente en la línea de comandos:

# 使用 Python 模块方式运行（推荐）
python -m github_trending_mcp

Integrar como servicio MCP en Roo Code

  1. Abre el archivo de configuración MCP de Roo Code:

    %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json

  2. Agrega la configuración del servicio GitHub Trending MCP:

    {
  "mcpServers": {
    // 其他服务配置...
    "github-trending-mcp": {
      "command": "python",
      "args": [
        "-m",
        "github_trending_mcp"
      ],
      "alwaysAllow": [
        "get_github_trending",
        "get_proxy_status"
      ],
      "disabled": false
    }
  }
}

  3. Guarda el archivo de configuración y reinicia Roo Code

Configuración de variables de entorno

Puedes configurar el proxy a través de las siguientes variables de entorno:

  • PROXY_HOST: dirección del host del proxy (por defecto "127.0.0.1")
  • PROXY_PORT: puerto del proxy (por defecto "10808")
  • PROXY_PROTOCOL: protocolo del proxy (por defecto "socks5")

Ejemplo de configuración de variables de entorno

Windows PowerShell:

$env:PROXY_HOST = "127.0.0.1"
$env:PROXY_PORT = "10808"
$env:PROXY_PROTOCOL = "socks5"

Windows CMD:

set PROXY_HOST=127.0.0.1
set PROXY_PORT=10808
set PROXY_PROTOCOL=socks5

Linux/macOS:

export PROXY_HOST=127.0.0.1
export PROXY_PORT=10808
export PROXY_PROTOCOL=socks5

Usar variables de entorno en la configuración MCP de Roo Code

{
  "mcpServers": {
    "github-trending-mcp": {
      "command": "python",
      "args": [
        "-m",
        "github_trending_mcp"
      ],
      "env": {
        "PROXY_HOST": "127.0.0.1",
        "PROXY_PORT": "10808",
        "PROXY_PROTOCOL": "socks5"
      },
      "alwaysAllow": [
        "get_github_trending",
        "get_proxy_status"
      ],
      "disabled": false
    }
  }
}

Referencia de la API

Herramienta: get_github_trending

Obtiene los repositorios populares de GitHub del día, incluyendo nombre, enlace, descripción y contenido del README.

Parámetros:

  • repo_limit: cantidad de repositorios a obtener, por defecto 5
  • use_proxy: si usar proxy, por defecto False
  • save_to_file: si guardar el resultado en un archivo, por defecto True

Retorno:

  • Información de los repositorios populares en formato Markdown

Ejemplo de llamada:

{
  "repo_limit": 10,
  "use_proxy": true,
  "save_to_file": true
}

Herramienta: get_proxy_status

Obtiene el estado actual de la configuración del proxy.

Parámetros: Ninguno

Retorno:

  • Un diccionario con la información de configuración del proxy

Ejemplo de salida

A continuación se muestra un ejemplo de salida:

## GitHub 今日热门仓库 Top 5

### 1. [username/repo-name](https://github.com/username/repo-name)
**About:** 仓库描述信息
**README:**
​```markdown
README 内容...
​```

### 2. [username2/repo-name2](https://github.com/username2/repo-name2)
**About:** 仓库描述信息
**README:**
​```markdown
README 内容...
​```

---
**总输出文本长度:** 12345

报告已保存到: C:\path\to\github_trending_2023-05-01.md

Nota: los bloques de código en la salida real se mostrarán correctamente; aquí se ha hecho un tratamiento especial para mostrar bloques de código anidados.

Guardado de archivos

Los resultados se guardarán como archivo Markdown, con el siguiente formato de nombre:

  • github_trending_YYYY-MM-DD.md

Si ya existe un archivo con el mismo nombre, se agregará automáticamente un número:

  • github_trending_YYYY-MM-DD_1.md
  • github_trending_YYYY-MM-DD_2.md
  • ...

Notas

  1. Asegúrate de que la conexión de red sea normal, o configura un proxy correcto
  2. La estructura de la página de GitHub puede cambiar; si encuentras errores de análisis, puede ser necesario actualizar la lógica de análisis
  3. Respeta los términos de uso y la política de rastreo de GitHub

Licencia

MIT © RusianHu