Zerops MCP

🚀 GitHub MCP サーバー

GitHub MCP（Model Context Protocol）サーバーは、GitHub プラットフォームとのインタラクション機能を提供します。以下の操作をサポートしています。

• コード検索：言語、パス、ファイル拡張子などの条件でコードを検索します。
• 問題追跡：問題（Issues）とプルリクエスト（Pull Requests）を表示および管理します。
• リポジトリ管理：リポジトリの作成、削除、管理を行います。
• チーム協力：チームメンバーと協力し、チームと権限を管理します。
• 活動監視：リポジトリのコミット履歴と活動記録を監視します。

✨ 主な機能

使用シーン

• 開発支援：コードスニペットや機能実装を迅速に見つけます。
• プロジェクト管理：問題とプルリクエストの状態を追跡します。
• 自動化ワークフロー：CI/CD ワークフローに統合して自動テストとデプロイを行います。
• チーム協力：チーム内で効率的にタスクを管理および分配します。

📦 インストール

環境設定

個人アクセストークン

GitHub 個人アクセストークンを作成します。

1. GitHub アカウント設定にログインします。
2. 必要な権限のあるリポジトリ（公開、すべて、または指定）を選択します。
3. repo 権限を持つトークンを作成します（公開リポジトリの場合は public_repo 権限を推奨）。

Claude Desktop への統合

以下の設定を claude_desktop_config.json に追加します。

Docker 方式：

{
  "mcpServers": {
    "github": {
      "type": "docker",
      "containerName": "github-mcp-server",
      "imageName": "ghcr.io/your-org/github-mcp:latest"
    }
  }
}

直接設定方式：

{
  "mcpServers": {
    "github": {
      "type": "direct",
      "endpoint": "http://localhost:3000",
      "token": "your-personal-access-token"
    }
  }
}

依存関係のインストール

必要な依存関係をインストールするには、以下のコマンドを実行します。

npm install @github/mcp-server --save

サーバーの初期化

以下の設定ファイル mcp-config.json を作成して実行します。

{
  "servers": {
    "github": {
      "url": "https://api.github.com",
      "token": "your-personal-access-token"
    }
  }
}

💻 使用例

コマンドラインツール

ツールのインストール

npm パッケージマネージャーを使用してインストールします。

npm install -g @github/mcp-cli

基本的な使用法

1. GitHub アカウントにログインします。

   mcp login --token your-personal-access-token
   

2. コードスニペットを検索します。

   mcp search "node.js" --language=typescript
   

3. 新しいリポジトリを作成します。

   mcp create-repo my-new-repo
   

検索操作

コード検索

以下の構文を使用すると、正確なコード検索が可能です。

• language:javascript：プログラミング言語でフィルタリングします。
• repo:owner/name：リポジトリの範囲を指定します。
• path:app/src：ファイルパスでフィルタリングします。
• extension:js：ファイル拡張子でフィルタリングします。
• 例：q: "import express" language:typescript path:src/

問題検索

以下の構文を使用すると、問題とプルリクエストの検索が可能です。

• is:issue または is:pr：タイプでフィルタリングします。
• is:open または is:closed：状態でフィルタリングします。
• label:bug：ラベルでフィルタリングします。
• author:username：作者でフィルタリングします。
• 例：q: "memory leak" is:issue is:open label:bug

ユーザー検索

以下の構文を使用すると、ユーザーまたは組織の検索が可能です。

• type:user または type:org：アカウントタイプでフィルタリングします。
• followers:>1000：フォロワー数でフィルタリングします。
• location:London：地理位置でフィルタリングします。
• 例：q: "fullstack developer" location:London followers:>100

詳細な検索構文については、GitHub 公式ドキュメントを参照してください。

📚 ドキュメント

よくある質問

1. 個人アクセストークンを取得する方法は？

• GitHub アカウントにログインし、アカウント設定にアクセスします。
• "Generate new token" ボタンをクリックします。
• 権限を設定してトークンを生成します。

2. 認証問題を解決する方法は？

• トークンが正しい権限（少なくとも repo 権限）を持っていることを確認します。
• トークンが期限切れまたは取り消されていないことを確認します。

開発ガイド

機能拡張

• カスタムコマンド：新しい CLI コマンドを開発して機能を拡張します。
• プラグインシステム：プラグイン可能なコンポーネントを作成してサーバー機能を拡張します。
• フックメカニズム：前処理と後処理のロジックを実装します。

コードの貢献

1. プロジェクトリポジトリを Fork します。
2. 機能ブランチを作成します。
3. コードをコミットし、Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細は以下の通りです。

MIT License
Copyright (c) [年份] [作者姓名]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

貢献者

• [あなたの名前] - 初期開発
• [他の貢献者の名前] - 機能拡張

以上のガイドを参照することで、GitHub MCP サーバーを開発フローに簡単に統合し、チーム協力の効率を向上させることができます。