소개

Anthropic의 MCP 프로토콜을 준수하는 샘플 앱입니다. Claude Desktop에서 MCP 서버로 실행되도록 설계되었으며, 사용자가 Airbyte 연결 상태를 확인할 수 있도록 합니다.

MCP 서버 구성

1. 가상 환경 관리를 위해 uv 설치

2. 가상 환경 만들기

지엑스피1

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

## 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"
      ]
    }
  }
}

2. Claude Desktop의 서버 목록에 서버를 추가합니다. Claude Desktop을 열고 설정 페이지로 이동합니다. 개발자 설정을 탭한 다음 "+" 버튼을 탭하여 새 서버를 추가합니다. 그러면 claude_desktop_config.json 파일의 위치가 표시됩니다. 이 파일을 열고 이 저장소에서 claude_desktop_config.json 파일의 내용을 붙여넣습니다. 그런 다음 Claude Desktop을 다시 시작합니다. 텍스트 입력란 오른쪽 하단에 있는 망치 아이콘을 확인하여 서버가 추가되었는지 확인할 수 있습니다.

Related MCP server: 302AI File Parser MCP Server

디버깅

claude_desktop_config.json 파일이 올바르게 구성된 경우 로그는 ~/Library/Logs/anthropic/claude-desktop-server.log에 기록됩니다. 로그가 보이지 않거나 망치 아이콘이 없는 경우 claude_desktop_config.json 파일이 이 리포지토리에 있는 파일과 정확히 일치하고 경로가 올바른지 확인하세요.