Github MCP Server In Go

🚀 GitHub MCP サーバーの Go 実装

このプロジェクトは、GitHub モデルコンテキストプロトコル（MCP）サーバーの Go 言語による実装です。AI アシスタントが GitHub API とやり取りして、リポジトリの作成、ブランチの管理、ファイル操作などの様々な操作を実行できるようになります。

🚀 クイックスタート

この GitHub MCP サーバーの Go 実装を使用することで、AI アシスタントが GitHub API とやり取りして様々な操作を実行できます。以下に、セットアップと使用方法の手順を説明します。

✨ 主な機能

• AI アシスタントが GitHub API とのやり取りを通じて、リポジトリの作成、ブランチの管理、ファイル操作などの操作を実行できます。
• 2 種類の認証方法（環境変数認証と HTTP ヘッダー認証）をサポートしています。
• 異なる Web フレームワーク間でのシームレスな統合を可能にし、一貫した認証メカニズムを維持します。
• 様々な GitHub 操作を行うためのツールを提供します。

📦 インストール

前提条件

• Go 1.21 以上のバージョン
• 適切な権限を持つ GitHub 個人用アクセストークン

インストールコマンド

go get github.com/metoro-io/github-mcp-server-go

🔧 認証方法

このサーバーは、2 種類の認証方法をサポートしています。

環境変数認証

GitHub 個人用アクセストークンを環境変数に設定します。

export GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token

HTTP ヘッダー認証

サーバーは、HTTP リクエストから認証トークンを抽出することもできます。Authorization ヘッダーを使用して GitHub トークンを渡すことができます。

Authorization: Bearer your_github_token

または、簡単に以下のように指定することもできます。

Authorization: your_github_token

コンテキストの渡し方

HTTP ハンドラーについて、サーバーは 2 種類の方法をサポートしています。

1. HTTP リクエストには標準の http_request コンテキスト値を使用します。
2. Gin フレームワークを使用する場合は ginContext 値を使用します。 これにより、異なる Web フレームワーク間でのシームレスな統合が可能になり、一貫した認証メカニズムを維持できます。

💻 使用例

基本的な使用法

1. GitHub 個人用アクセストークンを設定します（上記の認証方法を参照）。
2. サーバーを起動します。

go run main.go

📚 ドキュメント

利用可能なツール

このサーバーは以下のツールを提供します。

• search_repositories：GitHub リポジトリを検索します。
• create_repository：あなたのアカウントで新しい GitHub リポジトリを作成します。
• fork_repository：GitHub リポジトリをあなたのアカウントまたは指定された組織にフォークします。
• create_branch：GitHub リポジトリ内に新しいブランチを作成します。
• get_file_contents：GitHub リポジトリ内のファイルまたはディレクトリの内容を取得します。
• create_or_update_file：単一のファイルを作成または更新します。
• push_files：複数のファイルを一度に GitHub リポジトリにコミットします。
• create_issue：GitHub リポジトリ内に新しいイシューを作成します。
• get_issue：特定のイシューの詳細情報を取得します。
• list_issues：フィルタリングオプション付きで GitHub リポジトリ内のイシューをリストします。
• update_issue：既存のイシューを更新します。
• add_issue_comment：既存のイシューにコメントを追加します。
• list_commits：ブランチのコミットリストを取得します。
• search_code：GitHub リポジトリ内でコードを検索します。
• search_issues：GitHub リポジトリ内でイシューとプルリクエストを検索します。
• search_users：GitHub 上のユーザーを検索します。

🔧 技術詳細

プロジェクト構造

• main.go：アプリケーションのエントリーポイントです。
• common/：汎用ツールとエラー処理が含まれています。
• operations/：GitHub API 操作の実装が含まれています。
• tools/：MCP ツールの定義とハンドラーが含まれています。

ソースコードからのビルド

go build -o github-mcp-server

テストの実行

go test ./...

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。