Github MCP Server In Go

🚀 GitHub MCP 服務器的 Go 實現

這是 GitHub 模型上下文協議（MCP）服務器的 Go 語言實現方案。藉助該實現，AI 助手能夠與 GitHub API 進行交互，進而執行創建倉庫、管理分支、文件操作等各類操作。

🚀 快速開始

要使用此服務器，你需要完成先決條件的準備、安裝服務器、進行認證設置，最後啟動服務器。以下是詳細步驟：

1. 確保滿足先決條件。
2. 按照安裝指南完成安裝。
3. 選擇合適的認證方式進行認證。
4. 啟動服務器開始使用。

✨ 主要特性

• 支持 AI 助手與 GitHub API 交互，實現多種操作。
• 提供兩種認證方式，方便不同場景使用。
• 支持在不同 Web 框架間無縫集成，保持一致的身份驗證機制。
• 提供豐富的可用工具，涵蓋倉庫搜索、創建、文件操作、問題管理等多個方面。

📦 安裝指南

先決條件

• Go 1.21 或更高版本
• 具有適當權限的 GitHub 個人訪問令牌

安裝命令

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

💻 使用示例

基礎用法

認證設置

環境變量認證

將你的 GitHub 個人訪問令牌設置為環境變量：

export GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

HTTP 頭認證

服務器還可以從 HTTP 請求中提取身份驗證令牌。你可以通過 Authorization 標頭傳遞你的 GitHub 令牌：

Authorization: Bearer your_github_token

或簡單地：

Authorization: your_github_token

啟動服務器

go run main.go

高級用法

上下文傳遞

對於 HTTP 處理器，服務器支持兩種方式：

1. 標準的 http_request 上下文值用於 HTTP 請求。
2. 使用 Gin 框架時的 ginContext 值。 這使得在不同的 Web 框架之間無縫集成成為可能，同時保持一致的身份驗證機制。

📚 詳細文檔

可用工具

該服務器提供以下工具：

🔧 技術細節

項目結構

• main.go：應用程序的入口點
• common/：通用工具和錯誤處理
• operations/：GitHub API 操作實現
• tools/：MCP 工具定義和處理程序

從源代碼構建

go build -o github-mcp-server

運行測試

go test ./...

📄 許可證

此項目採用 MIT 許可證。