GitHub Star Count MCP Server

GitHub 星标计数 MCP 服务

一个模型上下文协议（MCP）服务，可让 Claude 获取 GitHub 仓库的星标数。

功能

• 获取任意公开 GitHub 仓库的星标数
• 通过 MCP 与 Claude Desktop 集成
• 用于获取仓库统计数据的简易 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 Desktop 集成

将以下内容添加到 Claude Desktop 配置文件（~/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 提示词示例

在 Claude Desktop 中配置 MCP 服务后，你可以使用如下提示词：

Use the github-star-count-mcp MCP server to get the star count for the repository "anthropics/claude-api" owned by "anthropics"

项目结构

• star_count.py：MCP 服务的主要实现
• github_integration.py：GitHub API 集成函数
• run_star_count.sh：用于运行 MCP 服务的辅助脚本
• test_mcp.py：用于验证的简单测试 MCP 服务

许可证

MIT

贡献

欢迎贡献！请随时提交 Pull Request。