MCP Feather Code

🚀 Feather Code MCP Server

Model Context Protocol (MCP) を使用した、Claude Desktop 用の包括的な GitHub 統合ツールです。15の強力なツールを使って、Claude から直接すべての GitHub 機能にアクセスできます。

✨ 主な機能

• 🚀 15のGitHubツール - GitHub API を完全に網羅
• 🔍 自動検出 - git からリポジトリを自動検出
• 🔐 柔軟な認証方式 - PAT、GitHub App、ファイルベースのトークンをサポート
• 📦 ゼロコンフィグ - 任意の 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

基本的な使用法

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

高度な使用法

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 App (上級者向け)

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 ツールを使用]

"authentication" を含む 5 つのファイルが見つかりました:
- src/auth/login.py
- src/auth/middleware.py
...

開発

テストの実行

python3 test_comprehensive.py
python3 validate_production_ready.py

ソースからビルド

pip install -e .

トラブルシューティング

"Repository not detected"

• git リポジトリで、GitHub リモートが設定されていることを確認してください
• または、GITHUB_OWNER と GITHUB_REPO 環境変数を設定してください

"Authentication failed"

• GitHub トークンに必要なスコープがあることを確認してください
• トークンが期限切れになっていないことを確認してください
• GitHub App 認証の代わりに PAT を使用してみてください

"Tool not found"

• 最新バージョンに更新してください
• Claude Desktop が MCP 設定を再読み込みしていることを確認してください

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

コントリビューション

コントリビューションは大歓迎です！以下の手順で行ってください:

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

サポート

• 📖 ドキュメント
• 🐛 問題の報告
• 💬 ディスカッション