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。