MCP Github Trending

🚀 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。