MCP Feather Code

🚀 Feather Code MCP 服務器

Feather Code MCP 服務器藉助模型上下文協議（MCP），為 Claude Desktop 提供全面的 GitHub 集成。通過 15 個強大的工具，你可以直接在 Claude 中訪問所有 GitHub 功能。

🚀 快速開始

Feather Code MCP 服務器能讓你在 Claude Desktop 裡無縫使用 GitHub 的各項功能。下面為你介紹安裝和使用的基本步驟。

✨ 主要特性

• 🚀 15 個 GitHub 工具 - 全面覆蓋 GitHub API 功能。
• 🔍 自動檢測 - 可從 Git 自動檢測倉庫信息。
• 🔐 靈活認證 - 支持個人訪問令牌（PAT）、GitHub 應用和基於文件的令牌。
• 📦 零配置 - 可在任何 Git 倉庫中直接使用。
• ✅ 符合 MCP 標準 - 基於官方 MCP SDK 構建。

📦 安裝指南

快速安裝（推薦）

Linux/macOS：

curl -fsSL https://raw.githubusercontent.com/yourusername/feather-code/main/install.sh | bash

Windows：

Invoke-WebRequest -Uri https://raw.githubusercontent.com/yourusername/feather-code/main/install.bat -OutFile install.bat
.\install.bat

手動安裝

1. 克隆倉庫：

   git clone https://github.com/yourusername/feather-code.git
   cd feather-code
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 配置認證：

   export GITHUB_PAT=your_github_personal_access_token
   

💻 使用示例

與 Claude Desktop 集成

將以下內容添加到你的 Claude Desktop 配置中：

{
  "mcpServers": {
    "feather-code": {
      "command": "python3",
      "args": ["/path/to/feather-code/feather_code.py"]
    }
  }
}

獨立使用

在任何 Git 倉庫中運行：

cd /your/github/repo
python3 /path/to/feather_code.py

可用工具

倉庫管理

• get_repository_info - 獲取倉庫的詳細信息。
• get_repository_languages - 獲取倉庫的語言分佈。
• get_repository_topics - 獲取倉庫的主題/標籤。

問題管理

• list_issues - 列出並過濾倉庫問題。
• create_issue - 創建帶有標籤的新問題。
• update_issue - 更新現有問題。
• get_issue - 獲取問題的詳細信息。
• add_issue_comment - 為問題添加評論。

拉取請求管理

• get_pull_requests - 列出並過濾拉取請求。
• create_pull_request - 創建新的拉取請求。
• get_pull_request - 獲取拉取請求的詳細信息。

代碼與倉庫

• list_branches - 列出倉庫的分支。
• get_commits - 按條件獲取提交歷史。
• get_file_content - 讀取倉庫中的文件內容。
• search_code - 在倉庫中搜索代碼。

🔧 技術細節

認證方式

個人訪問令牌（推薦）

1. 在 https://github.com/settings/tokens/new 創建令牌。
2. 選擇作用域：repo，read:org（用於私有倉庫）。
3. 設置令牌：

   export GITHUB_PAT=ghp_your_token_here
   

令牌文件

echo "ghp_your_token_here" > ~/.github_token
export GITHUB_PAT_FILE=~/.github_token

GitHub 應用（高級）

export GITHUB_APP_ID=123456
export GITHUB_INSTALLATION_ID=789012
export GITHUB_PRIVATE_KEY_PATH=/path/to/private-key.pem

配置參數

所有配置均通過環境變量完成：

使用示例

從 Claude 創建問題

用戶：創建一個標題為 "Bug: Login not working" 的新問題，並添加 bug 標籤

Claude：我將為你創建該問題。
[使用 create_issue 工具]

已創建問題 #123："Bug: Login not working"

搜索代碼

用戶：查找所有包含 "authentication" 的文件

Claude：我將搜索包含 "authentication" 的文件。
[使用 search_code 工具]

找到 5 個包含 "authentication" 的文件：
- src/auth/login.py
- src/auth/middleware.py
...

開發相關

運行測試

python3 test_comprehensive.py
python3 validate_production_ready.py

從源代碼構建

pip install -e .

故障排除

"Repository not detected"

• 確保你處於具有 GitHub 遠程倉庫的 Git 倉庫中。
• 或者設置 GITHUB_OWNER 和 GITHUB_REPO 環境變量。

"Authentication failed"

• 檢查你的 GitHub 令牌是否具有所需的作用域。
• 確保令牌未過期。
• 嘗試使用個人訪問令牌（PAT）而非 GitHub 應用認證。

"Tool not found"

• 更新到最新版本。
• 檢查 Claude Desktop 是否重新加載了 MCP 配置。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🤝 貢獻指南

歡迎貢獻代碼！請按照以下步驟操作：

1. 分叉倉庫。
2. 創建功能分支。
3. 進行修改。
4. 提交拉取請求。

🛠️ 支持與反饋

• 📖 文檔
• 🐛 報告問題
• 💬 討論區