MCP GitHub discussions

GitHub MCP服务器

模型上下文协议（MCP）的多功能和强大的服务器实现，旨在与GitHub存储库、问题、讨论等无缝交互。该服务器通过提供结构化界面来查询、更新和分析GitHub数据，实现了高效管理、自动化和增强协作。通过支持集成自定义工作流、处理存储库元数据以及促进与问题和讨论的实时交互，MCP服务器使开发人员和团队能够简化他们的GitHub体验。无论您是在构建工具、自动化任务，还是探索与GitHub生态系统互动的新方法，此服务器都为您的项目提供了坚实的基础。

概述

该MCP服务器提供了人工智能助手和GitHub API之间的桥梁，允许人工智能模型执行以下操作：

• 搜索存储库
• 查看讨论
• 分析存储库活动
• 正在获取存储库统计信息

特性

• 库管理：搜索、分析GitHub存储库并与之交互
• 讨论整合：分析GitHub讨论
• 活动分析：了解存储库活动和贡献
• 搜索功能：高级搜索存储库、代码和讨论

安装

先决条件

• Python 3.8+
• 具有适当权限的GitHub个人访问令牌

设置

1. 克隆存储库：

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

1. 安装依赖项：

   pip install requests

1. 在环境变量中设置您的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）

使用客户端

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许可证-有关详细信息，请参阅许可证文件