Go实现的GitHub MCP服务器

这是一个用Go语言实现的GitHub模型上下文协议（MCP）服务器。该实现允许AI助手与GitHub API交互，以执行诸如创建存储库、管理分支、操作文件等操作。

前提条件

• Go 1.21 或更高版本
• 具有适当权限的 GitHub 个人访问令牌

安装

go get github.com/metoro-io/github-mcp-server-go

身份验证

服务器支持两种身份验证方法：

环境变量身份验证

将您的 GitHub 个人访问令牌设置为环境变量：

export GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

HTTP Header 身份验证

服务器还可以从 HTTP 请求中提取身份验证令牌。您可以通过 Authorization header 传递您的 GitHub 令牌：

Authorization: Bearer your_github_token

或者简单地：

Authorization: your_github_token

上下文传递

对于 HTTP 处理程序，服务器支持以下两种方式：

1. 用于 HTTP 请求的标准 http_request 上下文值。
2. 使用 Gin 框架时的 ginContext 值。

这实现了与不同 Web 框架的无缝集成，同时保持一致的身份验证机制。

用法

1. 设置您的 GitHub 个人访问令牌（如身份验证部分所述）。

2. 运行服务器：

go run main.go

可用工具

服务器提供以下工具：

• search_repositories: 搜索 GitHub 存储库
• create_repository: 在您的帐户中创建一个新的 GitHub 存储库
• fork_repository: 将 GitHub 存储库 Fork 到您的帐户或指定的组织
• create_branch: 在 GitHub 存储库中创建一个新分支
• get_file_contents: 从 GitHub 存储库获取文件或目录的内容
• create_or_update_file: 在 GitHub 存储库中创建或更新单个文件
• push_files: 在单个提交中将多个文件推送到 GitHub 存储库
• create_issue: 在 GitHub 存储库中创建一个新 issue
• get_issue: 获取 GitHub 存储库中特定 issue 的详细信息
• list_issues: 列出 GitHub 存储库中的 issue，并带有过滤选项
• update_issue: 更新 GitHub 存储库中现有的 issue
• add_issue_comment: 向现有的 issue 添加评论
• list_commits: 获取 GitHub 存储库中某个分支的提交列表
• search_code: 在 GitHub 存储库中搜索代码
• search_issues: 在 GitHub 存储库中搜索 issue 和 pull request
• search_users: 在 GitHub 上搜索用户

开发

项目结构

• main.go: 应用程序的入口点
• common/: 通用实用程序和错误处理
• operations/: GitHub API 操作实现
• tools/: MCP 工具定义和处理程序

从源代码构建

go build -o github-mcp-server

运行测试

go test ./...

许可证

本项目采用 MIT 许可证。