導入

これはAnthropicのMCPプロトコルに準拠したサンプルアプリです。Claude DesktopでMCPサーバーとして動作するように設計されており、ユーザーはAirbyte接続のステータスを確認できます。

MCPサーバーの設定

仮想環境管理用のuvをインストールする
仮想環境を作成する

uv venv
source .venv/bin/activate

依存関係をインストールする

pip install -r requirements.txt

.envファイルを作成し、Airbyteキーを追加します

AIRBYTE_WORKSPACE_ID=xxx
AIRBYTE_CLIENT_ID=xxx
AIRBYTE_CLIENT_SECRET=xxx
AIRBYTE_API_KEY=xxx

アプリを実行する

uv run  airbyte_status_checker.py

## Configure claude desktop to use your MCP server
1. set absolute paths to uv and and the python file in claude_desktop_settings.json. It should look similar to this:
```json

  "mcpServers": {
    "airbyte-status-checker": {
      "command": "/Users/quintonwall/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/quintonwall/code/airbyte-mcp-list-sources",
        "run",
        "airbyte_status_checker.py"
      ]
    }
  }
}

claudeデスクトップのサーバーリストにサーバーを追加します。Claudeデスクトップを開き、設定ページに移動します。「開発者設定」をタップし、「+」ボタンをタップして新しいサーバーを追加します。claude_desktop_config.jsonファイルの場所が表示されます。これを開き、このリポジトリからclaude_desktop_config.jsonファイルの内容を貼り付けます。その後、claudeデスクトップを再起動します。テキスト入力ボックスの右下にあるハンマーアイコンでサーバーが追加されたことがわかります。

Related MCP server: Ledger MCP Server

デバッグ

claude_desktop_config.json ファイルが正しく設定されていれば、ログは ~/Library/Logs/anthropic/claude-desktop-server.log に書き込まれます。ログが表示されない場合、またはハンマーアイコンが表示されない場合は、claude_desktop_config.json ファイルがこのリポジトリにあるものと完全に一致し、パスが正しいことを確認してください。