소개
Anthropic의 MCP 프로토콜을 준수하는 샘플 앱입니다. Claude Desktop에서 MCP 서버로 실행되도록 설계되었으며, 사용자가 Airbyte 연결 상태를 확인할 수 있도록 합니다.
MCP 서버 구성
- 가상 환경 관리를 위해 uv 설치
- 가상 환경 만들기
지엑스피1
- 종속성을 설치하세요
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 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 파일이 이 리포지토리에 있는 파일과 정확히 일치하고 경로가 올바른지 확인하세요.