Overview

This demonstration application adheres to the Anthropic MCP specification. It is designed to function as an MCP server accessible within Claude Desktop, primarily facilitating user queries regarding the current state of Airbyte connections.

Setting Up Your MCP Server Instance

1. Utilize 'uv' for isolated Python environment configuration.

2. Establish a dedicated virtual environment: bash uv venv source .venv/bin/activate

3. Install required packages from the manifest file: bash pip install -r requirements.txt

4. Provision a configuration file named .env containing necessary Airbyte credentials: bash AIRBYTE_WORKSPACE_ID=xxx AIRBYTE_CLIENT_ID=xxx AIRBYTE_CLIENT_SECRET=xxx AIRBYTE_API_KEY=xxx

5. Launch the service: bash uv run airbyte_status_checker.py

Configuring Claude Desktop for Server Access

1. Specify the absolute filesystem paths for both 'uv' and the primary Python execution file within claude_desktop_settings.json. The structure should resemble 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" ] } } }

1. Integrate the newly configured server into Claude Desktop's active server registry. Navigate to the application settings, access Developer Settings, and select the '+' icon to introduce a new server endpoint. This action will reveal the location of your claude_desktop_config.json file. Insert the repository's content for claude_desktop_config.json into that file, then perform a restart of Claude Desktop. Successful registration is indicated by the appearance of a small hammer icon adjacent to the text input area.

Troubleshooting Guidance

If the claude_desktop_config.json file is correctly formatted, operational output is directed to ~/Library/Logs/anthropic/claude-desktop-server.log. Absence of log entries or the visibility of the hammer icon mandates a rigorous verification that your claude_desktop_config.json precisely mirrors the provided repository configuration and that all specified file paths are accurate.