Airbyte Status Checker

🚀 このアプリケーションについて

このアプリケーションは、Anthropic社のMCPプロトコルに準拠したサンプルアプリケーションです。Claude Desktop内のMCPサーバーとして動作し、Airbyte接続の状態をユーザーが確認できるように設計されています。

🚀 クイックスタート

📦 インストール

1. 仮想環境管理用のuvをインストール

2. 仮想環境を作成

uv venv
source .venv/bin/activate

3. 依存関係をインストール

pip install -r requirements.txt

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

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

5. アプリケーションを実行

uv run  airbyte_status_checker.py

💻 Claude Desktopでの使用設定

1. claude_desktop_settings.jsonにuvとPythonファイルの絶対パスを設定

以下のような内容になります。

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

2. Claude Desktopのサーバーリストにサーバーを追加

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

🔧 デバッグ

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