GitHub Trending MCP

Fetches trending repositories from GitHub and saves them as Markdown files. Supports proxy configuration.

GitHub

GitHub Trending MCP

这是一个基于 FastMCP 框架的 GitHub 热门仓库获取工具，可以一次性获取 GitHub 当日的可选个数的热门仓库的详细信息，包括名称、链接、描述和 README 内容。 这样你就不用一篇一篇的翻README来总结博客了，可以节省AI 的 Tokens 。

功能特点

  • 获取 GitHub 当日热门仓库列表
  • 支持自定义获取仓库数量
  • 支持代理配置（通过环境变量）
  • 支持将结果保存为 Markdown 文件
  • 自动处理同名文件，避免覆盖

安装方法

从仓库安装

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

从本地安装

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

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

使用方法

作为命令行工具运行

安装后，可以直接在命令行中运行：

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

作为 MCP 服务集成到 Roo Code

  1. 打开 Roo Code 的 MCP 配置文件：

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

  2. 添加 GitHub Trending MCP 服务配置：

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

  3. 保存配置文件并重启 Roo Code

环境变量配置

可以通过以下环境变量配置代理：

  • PROXY_HOST: 代理主机地址（默认为 "127.0.0.1"）
  • PROXY_PORT: 代理端口（默认为 "10808"）
  • PROXY_PROTOCOL: 代理协议（默认为 "socks5"）

设置环境变量示例

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

在 Roo Code MCP 配置中使用环境变量

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

API 参考

工具：get_github_trending

获取 GitHub 当日热门仓库，包括名称、链接、描述和 README 内容。

参数：

  • repo_limit: 要获取的仓库数量，默认为 5
  • use_proxy: 是否使用代理，默认为 False
  • save_to_file: 是否保存结果到文件，默认为 True

返回：

  • Markdown 格式的热门仓库信息

示例调用：

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

工具：get_proxy_status

获取当前代理配置状态。

参数： 无

返回：

  • 包含代理配置信息的字典

输出示例

下面是一个输出示例：

## 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

注意：实际输出中的代码块会正确显示，这里为了展示嵌套的代码块而做了特殊处理。

文件保存

结果将保存为 Markdown 文件，文件名格式为：

  • github_trending_YYYY-MM-DD.md

如果同名文件已存在，将自动添加序号：

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

注意事项

  1. 确保网络连接正常，或配置正确的代理
  2. GitHub 页面结构可能会变化，如果遇到解析错误，可能需要更新解析逻辑
  3. 请遵守 GitHub 的使用条款和爬虫政策

许可证

MIT © RusianHu

Related Servers