Github Repository Inspector

🚀 MCP-Inspector-v0.6.0：GitHub MCP 服務器

本項目實現了 Model Context Protocol (MCP) 服務器，可讓人工智能助手（如 Claude）與 GitHub 倉庫、問題和拉取請求進行交互，極大提升了 AI 與 GitHub 生態的協作效率。

🚀 快速開始

本服務器能使人工智能助手與 GitHub 倉庫、問題和拉取請求進行交互。啟動前，請確保滿足以下先決條件：

• Python 3.8+
• GitHub API 令牌

安裝步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 設置你的 GitHub 令牌為環境變量：

   export GITHUB_TOKEN=your_github_token_here
   

4. 運行服務器：

   python server.py
   

服務器將在 http://localhost:5000 上啟動。

✨ 主要特性

• 倉庫搜索：根據搜索查詢查找 GitHub 倉庫
• 問題管理：獲取、創建和評論問題
• 拉取請求處理：查看和管理拉取請求
• 倉庫分析：獲取倉庫的統計信息和見解

💻 使用示例

端點

MCP 服務器提供以下端點：

• GET /mcp/discover：返回可用操作及其參數
• POST /mcp/execute：根據提供的參數執行操作

基礎用法

發現

curl -X GET http://localhost:5000/mcp/discover

執行倉庫搜索

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "search_repositories",
    "parameters": {
      "query": "machine learning"
    }
  }'

獲取倉庫問題

curl -X POST http://localhost:5000/mcp/execute \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "get_repo_issues",
    "parameters": {
      "owner": "openai",
      "repo": "whisper"
    }
  }'

📚 詳細文檔

架構

服務器遵循 Model Context Protocol 規範，以允許 AI 助手：

1. 發現可用操作
2. 執行帶有適當參數的操作
3. 以結構化格式處理和返回結果

擴展服務器

你可以通過以下方式擴展服務器：

1. 在 discover() 函數中添加新的端點
2. 實現相應的處理函數
3. 更新 execute() 函數中的路由

安全注意事項

• 服務器使用 API 令牌進行 GitHub 身份驗證
• 實現速率限制以防止濫用
• 對所有參數進行輸入驗證
• 考慮實現 OAuth 以獲得更安全的令牌管理

演示

請參閱演示視頻瞭解服務器功能的 walkthrough。

📄 許可證

本項目採用 MIT License。

📞 聯繫

有關問題或支持，請在此倉庫上打開問題。