Airbyte Status Checker

🚀 Example Application for Anthropic's MCP Protocol

This is an example application that complies with Anthropic's MCP protocol. It is designed to run as an MCP server in Claude Desktop, allowing users to check the status of Airbyte connections.

🚀 Quick Start

📦 Installation

1. Install uv for virtual environment management.
2. Create a virtual environment:

uv venv
source .venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Create a .env file and add your Airbyte keys:

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

5. Run the application:

uv run  airbyte_status_checker.py

💻 Usage in Claude Desktop

1. Set the absolute paths of uv and the Python file in claude_desktop_settings.json. It should look like this:

{
  "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. Add the server to the server list in Claude Desktop: Open Claude Desktop and navigate to the settings page. Click on Developer Settings, then click the "+" button to add a new server. This will show the location of your claude_desktop_config.json file. Open this file and paste the contents of the claude_desktop_config.json file from this repo. Then restart Claude Desktop. You can confirm that your server has been successfully added by seeing a hammer icon at the bottom of the text input box.

🔧 Debugging

If your claude_desktop_config.json file is configured correctly, logs will be written to ~/Library/Logs/anthropic/claude-desktop-server.log. If you don't see any logs or the hammer icon, check if your claude_desktop_config.json file exactly matches the content in this repo and ensure that the paths are correct.