Github Integration Server

🚀 GitHub MCP 服務器

這是一款用於與 GitHub 交互的模型上下文協議（MCP）服務器。藉助此工具，AI 助手能夠執行各類 GitHub 操作，涵蓋倉庫管理、文件操作、問題跟蹤等諸多方面，為用戶提供便捷高效的 GitHub 交互體驗。

🚀 快速開始

本服務器可讓 AI 助手輕鬆執行多種 GitHub 操作。使用前，需確保滿足先決條件，並完成安裝與配置。

✨ 主要特性

• 倉庫操作：支持創建倉庫以及叉取倉庫。
• 文件操作：可創建、更新和讀取文件，還能在單個提交中推送多個文件。
• 問題管理：能夠創建、更新、列出問題，並對問題進行評論。
• 拉取請求：支持創建拉取請求。
• 分支管理：可以創建分支。
• 搜索能力：可搜索代碼、倉庫、問題和用戶。
• 提交歷史：能列出提交歷史。

📦 安裝指南

先決條件

• Node.js 18 或更高版本。
• 具備適當權限的 GitHub 個人訪問令牌。

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

配置

此 MCP 服務器需要一個 GitHub 個人訪問令牌來進行 GitHub API 的身份驗證。該令牌應通過環境變量提供：

GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here

當使用 Smithery 部署時，可以通過 githubPersonalAccessToken 配置選項來配置令牌。

💻 使用示例

本地運行

要本地運行服務器，可使用以下命令：

GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here node dist/index.js

與 Smithery 部署

此倉庫包含用於與 Smithery 部署的必要配置文件：

• Dockerfile：定義如何構建 MCP 服務器的 Docker 鏡像。
• smithery.yaml：配置 Smithery 如何啟動 MCP 服務器。

請參考 Smithery 文檔 瞭解部署說明。

📚 詳細文檔

開發

構建

npm run build

代碼檢查

npm run lint

📄 許可證

本項目採用 MIT 許可證。