Github MCP

🚀 GitHub 星標計數 MCP 服務器

這是一個模型上下文協議（MCP）服務器，可讓 Claude 獲取 GitHub 倉庫的星標數量，為相關操作提供便利。

🚀 快速開始

本項目是一個模型上下文協議（MCP）服務器，允許 Claude 獲取來自 GitHub 倉庫的星標數量。通過以下步驟，你可以快速搭建並使用該服務器。

✨ 主要特性

• 星標獲取：能夠獲取任意公共 GitHub 倉庫的星標數量。
• Claude 集成：可通過 MCP 集成到 Claude 桌面。
• 簡單 API：提供簡單的 API 用於獲取倉庫統計數據。

📦 安裝指南

⚙️ 先決條件

• 需要 Python 3.11 及以上版本。
• 使用 uv 進行依賴管理。
• 準備好 GitHub 個人訪問令牌。

🛠️ 安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/yourusername/gh_mcp.git
   cd gh_mcp
   

2. 安裝依賴項：

   uv venv
   source .venv/bin/activate
   uv pip install -r requirements.txt
   

3. 創建包含 GitHub 令牌的 .env 文件：

   GITHUB_TOKEN=your_github_token_here
   

💻 使用示例

🏃‍♂️ 運行 MCP 服務器

你可以直接運行 MCP 服務器：

python star_count.py

或者使用提供的 Shell 腳本：

./run_star_count.sh

🖥️ 集成到 Claude 桌面

在您的 Claude 桌面配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下內容：

"github-star-count-mcp": {
  "command": "/bin/bash",
  "args": [
    "/path/to/gh_mcp/run_star_count.sh"
  ]
}

💬 示例提示用於 Claude

一旦 MCP 服務器配置到 Claude 桌面，您可以使用類似以下的提示：

使用 github-star-count-mcp MCP 服務器獲取倉庫 "anthropics/claude-api"（所有者為 "anthropics"）的星標數量

📚 詳細文檔

📁 項目結構

• star_count.py：MCP 服務器的主要實現文件。
• github_integration.py：GitHub API 集成函數。
• run_star_count.sh：運行 MCP 服務器的輔助腳本。
• test_mcp.py：用於驗證的簡單測試 MCP 服務器。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。