Github Issues

🚀 GitHub MCP サーバー

このサーバーは、Cline を介して GitHub の問題とやり取りする Model Context Protocol (MCP) サーバーの実装です。

✨ 主な機能

• リポジトリ内の GitHub の問題を一覧表示する
• 新しい GitHub の問題を作成する
• エラー処理と検証を行う
• 環境変数を使用した安全な認証を実現する

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/timbuchinger/mcp-github.git
cd mcp-github

2. uv を使用して依存関係をインストールします：

pip install uv
uv venv
source .venv/bin/activate  # Windowsの場合：.venv\Scripts\activate
uv pip install -r requirements.txt

3. 環境変数のテンプレートをコピーし、GitHub トークンを設定します：

cp .env.template .env

.env ファイルを編集し、GitHub の個人用アクセストークンを追加します：

GITHUB_TOKEN=your_token_here

GitHub の個人用アクセストークンを作成する方法：

1. GitHub の設定 -> 開発者設定 -> 個人用アクセストークンに移動します。
2. repo 権限を使用して新しいトークンを生成します。
3. トークンをコピーし、.env ファイルに貼り付けます。

💻 使用例

基本的な使用法

MCP サーバーを起動します：

python -m src.mcp_github.server

このサーバーは、Cline に対して 2 つのツールを公開します。

get_issues

GitHub リポジトリから問題のリストを取得します：

{
  "repo": "owner/repo"
}

create_issue

GitHub リポジトリに新しい問題を作成します：

{
  "repo": "owner/repo",
  "title": "問題のタイトル",
  "body": "問題の説明"
}

🔧 技術詳細

エラー処理

サーバーは一般的なエラーを処理します：

• GitHub トークンが不足している
• 無効なリポジトリ名
• 必要なパラメータが欠落している
• GitHub API エラー

エラー応答には、問題のトラブルシューティングを支援するための説明メッセージが含まれています。

開発

このプロジェクトは、依存関係の管理に uv を使用しています。開発環境を設定するには：

# すべての依存関係（開発用依存関係を含む）をインストールする
uv pip install -r requirements.txt

# テストを実行する
pytest

# コードをフォーマットする
black .

# 型チェックを行う
mypy .