🚀 MCP-GitHub-Trending 服务端

MCP-GitHub-Trending 服务端是一个 MCP 服务器，借助简单的 API 接口，为用户提供对 GitHub 热门仓库和开发者数据的便捷访问。

🚀 快速开始

MCP-GitHub-Trending 服务端可让你轻松访问 GitHub 热门仓库和开发者数据。下面为你介绍如何安装和使用该服务端。

✨ 主要特性

• 数据访问：可访问 GitHub 热门仓库和开发者数据。
• 语言过滤：支持按编程语言、常用语言进行过滤。
• 时间筛选：能按时间段（日、周、月）进行过滤。
• 优质响应：返回格式良好的 JSON 响应。

📦 安装指南

先决条件

• Python 3.12

安装步骤

安装包：

pip install mcp-github-trending

Claude Desktop 配置

在 MacOS 上：

~/Library/Application\ 支持/Claude/claude_desktop_config.json

在 Windows 上：

%APPDATA%/Claude/claude_desktop_config.json

api:
  host: "0.0.0.0"
  port: 8090

💻 使用示例

基础用法

get_github_trending_repositories

获取 GitHub 热门仓库，支持以下参数：

• language (可选)：编程语言筛选仓库（例如 "python", "javascript"）
• since (可选)：时间段筛选 ("daily", "weekly", "monthly")。默认为 "daily"
• spoken_language (可选)：常用语言筛选

示例响应：

[
  {
    "name": "仓库名称",
    "fullname": "所有者/仓库名称",
    "url": "https://github.com/owner/repository-name",
    "description": "仓库描述",
    "language": "Python",
    "stars": 1000,
    "forks": 100,
    "current_period_stars": 50
  }
]

get_github_trending_developers

获取 GitHub 热门开发者，支持以下参数：

• language (可选)：编程语言筛选（例如 "python", "javascript"）
• since (可选)：时间段筛选 ("daily", "weekly", "monthly")。默认为 "daily"

示例响应：

[
  {
    "username": "开发者",
    "name": "开发者名称",
    "url": "https://github.com/developer",
    "avatar": "https://avatars.githubusercontent.com/u/123456",
    "repo": {
      "name": "仓库名称",
      "description": "仓库描述",
      "url": "https://github.com/developer/repository-name"
    }
  }
]

📚 详细文档

项目结构

mcp-github-trending/
├── config.yaml      # 配置文件
├── requirements.txt # 依赖管理
├── src/             # 源代码目录
│   ├── main.py     # 主程序
│   └── api/        # API 接口目录
└── README.md        # 说明文档

运行

# 安装依赖
pip install -r requirements.txt

# 启动服务端
python src/main.py

调试

使用 MCP Inspector

可以通过以下命令启动调试模式：

uvicorn --reload src.app:app --host 0.0.0.0 --port 8090

访问 http://localhost:8090/docs 查看 API 文档。

📄 许可证

本项目采用 MIT License。