Github Oauth MCP Server

🚀 開発ガイド

このプロジェクトは、Pythonを使用した開発環境を構築し、Claudeデスクトップアプリケーションをローカルで実行するためのガイドです。また、MCPサーバーのデバッグ方法についても説明します。

🚀 クイックスタート

📦 インストール

まず、uvをインストールし、Pythonプロジェクトと環境を設定します。

MacOS/Linux : curl -LsSf https://astral.sh/uv/install.sh | sh  
Windows : powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

インストールが完了したら、ターミナルを再起動して、uvコマンドが有効になっていることを確認してください。

💻 使用例

基本的な使用法

次に、プロジェクトを作成して設定します。

ローカルのClaudeデスクトップアプリケーションでの実行

1. ツールを登録するために、claude_desktop_config.jsonファイルを更新する必要があります。

claude_desktop_config.jsonの場所を見つける：

Windows : code $env:AppData\Claude\claude_desktop_config.json  
Mac/Linux : code ~/Library/Application\ Support/Claude/claude_desktop_config.json

以下の内容を設定ファイルに追加してください：

{
  "mcpServers": {
    "Github-Oauth": {
      "command": "C:\\Users\\Hp\\.local\\bin\\uv",
      "args": [
        "--directory",
        "C:\\Users\\Hp\\Github-Oauth\\src\\github_oauth",
        "run",
        "server.py"
      ]
    }
  }
}

高度な使用法

デバッグ

MCPサーバーはstdioを通じて実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspectorの使用を強くお勧めします。

以下のコマンドでMCP Inspectorを起動できます：

npx @modelcontextprotocol/inspector uv --directory C:\Users\Hp\Github-Oauth run github-oauth

起動後、InspectorはブラウザにURLを表示し、そこからデバッグを開始できます。