Github MCP Server 1zs

🚀 GitHub MCP 服務器

本項目是一個用於 GitHub 倉庫的模型上下文協議 (MCP) 服務器，藉助 Python SDK 構建而成。它能讓 AI 助手訪問倉庫上下文，如文件、提交歷史、問題和拉取請求等，為開發者提供了便利。

🚀 快速開始

此服務器實現了 模型上下文協議 (MCP)，專門用於 GitHub 倉庫，可使 AI 助手訪問倉庫的各類上下文信息。它基於 MCP Python SDK 構建，並設計為可部署在 Heroku 上。

✨ 主要特性

• 🔍 可訪問 GitHub 倉庫文件和內容
• 📜 能夠檢索提交歷史
• 🐞 支持訪問問題和拉取請求
• 🔒 具備安全身份驗證和訪問控制功能
• ⚙️ 對 GitHub API 進行速率限制和緩存處理
• 🤝 與 MCP 支持的 AI 助手兼容

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/FixingPixels/mcp-server.git
   cd mcp-server
   

2. 創建虛擬環境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

4. 設置環境變量：

   cp .env.example .env
   # 使用你的 GitHub API 令牌和其他設置編輯 .env 文件
   

💻 使用示例

基礎用法

在本地進行開發時，可使用以下命令啟動服務器：

uvicorn src.mcp_server.main:app --reload

高級用法

此服務器設計為部署在 Heroku 上。若要進行部署，請參閱 部署文檔 瞭解詳細信息。

📚 詳細文檔

• API 文檔
• 配置指南
• 部署指南
• 故障排除

🤝 貢獻

歡迎大家為項目貢獻力量！請隨意提交 Pull Request。

📄 許可證

此項目遵循 MIT 許可證 - 詳情請查看 LICENSE 文件。