GitHub MCP Server

GitHub MCP 服务

一个多功能且强大的模型上下文协议（MCP）服务实现，旨在与 GitHub 仓库、议题、讨论等进行无缝交互。该服务提供结构化接口，用于查询、更新和分析 GitHub 数据，从而实现高效管理、自动化和协作增强。它支持集成自定义工作流、处理仓库元数据，以及促进与议题和讨论的实时交互，帮助开发者和团队简化 GitHub 使用体验。无论你是在构建工具、自动执行任务，还是探索与 GitHub 生态互动的新方式，该服务都能为你的项目提供稳健的基础。

概述

此 MCP 服务在 AI 助手与 GitHub API 之间搭建桥梁，使 AI 模型能够执行以下操作：

• 搜索仓库
• 查看讨论
• 分析仓库活动
• 获取仓库统计信息

功能

• 仓库管理：搜索、分析 GitHub 仓库并与之交互
• 讨论集成：分析 GitHub Discussions
• 活动分析：了解仓库活动和贡献情况
• 搜索功能：高级搜索仓库、代码和讨论

安装

先决条件

• Python 3.8+
• 具有相应权限的 GitHub Personal Access Token

设置

1. 克隆仓库：

   git clone https://github.com/jasona7/mcp_github_discussions.git
   cd mcp_github_discussions
   

2. 安装依赖项：

   pip install requests
   

3. 在环境变量中设置 GitHub 令牌：

   export GITHUB_TOKEN=your_github_personal_access_token
   

使用方法

启动服务

使用以下命令启动服务：

python scripts/mcp/github/mcp_github_server.py

服务默认将在 localhost:8004 上启动。

可用工具

此服务提供以下工具：

• search_repositories：根据各种条件搜索仓库
• get_repository_details：获取仓库的详细信息
• get_repository_issues：获取仓库中的议题
• get_repository_discussions：获取仓库中的讨论
• get_top_repos_by_activity：按活动情况获取热门仓库

配置

可以使用以下环境变量配置服务：

• GITHUB_TOKEN：你的 GitHub Personal Access Token
• MCP_HOST：服务绑定的主机（默认：localhost）
• MCP_PORT：服务绑定的端口（默认：8004）

使用客户端

python scripts/mcp/github/mcp_github_client.py
╭──────────────────────────────── GitHub Discussions Explorer ────────────────────────────────╮
│ MCP GitHub Discussions Explorer                                                             │
│ A terminal UI for interacting with GitHub Discussions                                       │
╰─────────────────────────────────────────────────────────────────────────────────────────────╯
Connecting to server...
Connected to server. 5 tools available.

Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1): 1

Browse Top Repositories:
1. Top Repos by Recent Activity
2. Top Repos by Star Count
3. Top Python Repos
4. Top JavaScript Repos
5. Top AI/LLM Repos
6. Back to Main Menu
Select repository category [1/2/3/4/5/6] (1): 3
Number of repositories to show (10): 3
Finding top Python repositories...
                             Top Repositories (3)                             
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ # ┃ Repository                       ┃ Stars  ┃ Language ┃ Has Discussions ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ 1 │ public-apis/public-apis          │ 334406 │ Python   │ ✗               │
│ 2 │ donnemartin/system-design-primer │ 294897 │ Python   │ ✗               │
│ 3 │ vinta/awesome-python             │ 238668 │ Python   │ ✗               │
└───┴──────────────────────────────────┴────────┴──────────┴─────────────────┘
None of the repositories have discussions enabled.

Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1): 

故障排除

• 连接被拒绝：确保服务正在运行，并且端口未被防火墙阻止
• 身份验证错误：确认你的 GitHub 令牌具有必要的权限
• 速率限制：GitHub API 有速率限制；服务会处理这些限制，但在使用量较大时可能会变慢

许可证

MIT 许可证——详情请参阅 LICENSE 文件