🚀 GitHub MCP 服务器
一个通用且强大的 Model Context Protocol (MCP) 服务器实现，它能与 GitHub 仓库、问题、讨论等进行无缝交互。通过提供结构化接口，该服务器可高效管理、自动化和增强协作，让 AI 模型能够查询、更新和分析 GitHub 数据。支持自定义工作流集成、处理仓库元数据以及实现实时问题和讨论交互等功能，为开发者和团队提供了强大工具，极大简化了他们在 GitHub 生态系统中的操作体验。无论你是在构建工具、自动化任务，还是探索与 GitHub 社区互动的新方法，此服务器都能为你提供坚实基础。
🚀 快速开始
此 MCP 服务器在 AI 助手和 GitHub API 之间架起了一座桥梁，允许 AI 模型执行以下操作：
- 搜索仓库
- 查看讨论
- 分析仓库活动
- 获取仓库统计信息
✨ 主要特性
- 仓库管理：搜索、分析并交互 GitHub 仓库
- 讨论集成：分析 GitHub Discussions
- 活动分析：获取仓库活动和贡献的洞察
- 搜索能力：支持基于代码、仓库和讨论的高级搜索
📦 安装指南
先决条件
- Python 3.8+
- GitHub 个人访问令牌（带有适当权限）
设置
- 克隆仓库：
git clone https://github.com/jasona7/mcp_github_discussions.git
cd mcp_github_discussions
- 安装依赖项：
pip install requests
- 在环境变量中设置 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 个人访问令牌 |
MCP_HOST |
服务器绑定的主机（默认：localhost） |
MCP_PORT |
服务器绑定的端口（默认：8004） |
🔧 技术细节
故障排除
- 连接被拒绝：确保服务器正在运行且端口未被防火墙阻止
- 身份验证错误：检查 GitHub 令牌是否具有必要的权限
- 速率限制：GitHub API 具有速率限制；服务器将处理这些情况，但在高使用期间可能会变慢
📄 许可证
MIT 许可证 - 请参阅 LICENSE 文件以获取详细信息