GitHub MCP サーバー

Cline を通じて GitHub の問題と対話するための Model Context Protocol (MCP) サーバー実装。

特徴

• リポジトリからGitHubの問題を一覧表示する

• 新しいGitHubの問題を作成する

• エラー処理と検証

• 環境変数による安全な認証

Related MCP server: GitHub MCP Server

インストール

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

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

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

pip install uv
uv venv
source .venv/bin/activate  # On 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

サーバーが起動し、2 つのツールが Cline に公開されます。

get_issues

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

{
  "repo": "owner/repo"
}

問題作成

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

{
  "repo": "owner/repo",
  "title": "Issue title",
  "body": "Issue description"
}

エラー処理

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

• GitHubトークンがありません

• リポジトリ名が無効です

• 必要なパラメータが不足しています

• GitHub APIエラー

エラー応答には、問題のトラブルシューティングに役立つ説明メッセージが含まれます。

発達

このプロジェクトでは依存関係の管理にUVを使用しています。開発環境をセットアップするには、以下の手順に従ってください。

# Install all dependencies (including dev dependencies)
uv pip install -r requirements.txt

# Run tests
pytest

# Format code
black .

# Type checking
mypy .