Weather/GitHub MCP Server

Weather/GitHub MCP サーバー

このプロジェクトでは、GitHub リポジトリやイシューを操作するためのツールを備えた GitHub MCP サーバーを提供します。

要件

• Python 3.10 以降
• uv（高速な Python パッケージ／依存関係マネージャー）
• GitHub パーソナルアクセストークン（イシューの作成に必要）

セットアップと使用方法

1. このリポジトリをクローンし、uv を使って依存関係をインストールします：

uv init mcp-server-demo
cd mcp-server-demo
uv run ../github.py

すでにプロジェクトディレクトリにいる場合は、次のようにします：

uv run github.py

2. GitHub トークンを設定します：

プロジェクトのルートに .env ファイルを作成し、次の内容を記述します：

GITHUB_TOKEN=your_personal_access_token_here

または、シェルでエクスポートします：

export GITHUB_TOKEN=your_personal_access_token_here

機能

• GitHub ユーザーの公開リポジトリを一覧表示する
• リポジトリのイシューを一覧表示する
• リポジトリにイシューを作成する

注意事項

• トークンに、リポジトリとイシューへのアクセスに必要な権限があることを確認してください。
• このサーバーは FastMCP を使い、MCP プロトコルで動作します。

MCP サーバーの設定

Cursor で MCP サーバーを使用できるようにするには、~/.cursor/mcp.json ファイルで設定します。設定例：

{
  "mcpServers": {
    "github": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/github-mcp-demo",
        "run",
        "github.py"
      ]
    }
  }
}

この設定によって、Cursor は MCP サーバーの起動方法と使用するコマンドを認識します。

例：Cursor の設定 UI

以下は、Cursor で MCP サーバーが使用可能になっている状態を示すスクリーンショットです：

Cursor での MCP サーバーのステータス

Cursor の設定 UI では、設定済みの MCP サーバーが表示され、それぞれのサーバーが ON（有効）か OFF（無効）かを確認できます。これにより、使用可能なツールをすぐに把握できます。

以下にスクリーンショットを追加して説明してください：