Atrax: MCP 서버 집계 프록시 v0.1.0
지엑스피1
Atrax는 여러 대의 MCP 서버를 통합하여 단일 통합 인터페이스로 제공하는 MCP(Model Context Protocol) 서버용 프록시입니다. 이름은 "깔때기 모양의 거미줄"에서 유래되었으며, 여러 서버의 리소스를 하나로 모으는 방식을 나타냅니다.
특징
- 리소스 집계 : 구성 가능한 충돌 해결을 통해 여러 서버의 리소스를 결합합니다.
- 투명 프록싱 : 클라이언트에게 통합된 MCP 서버 인터페이스를 제공합니다.
- 프로토콜 준수 : MCP 프로토콜 사양을 엄격히 준수합니다.
- 모듈형 디자인 : 구성 요소 간의 관심사를 명확하게 분리
- 다양한 전송 유형 : STDIO, HTTP/SSE 및 Docker 전송 지원
- 향상된 오류 처리 : 상황에 맞는 정보를 포함한 자세한 오류 보고
- 웹 통합 : 브라우저 및 웹 기반 클라이언트를 위한 HTTP/SSE 전송
- 인증 지원 : 서버 액세스 보안을 위한 토큰 기반 인증
빠른 시작
# Clone the repository
git clone https://github.com/yourusername/atrax.git
cd atrax
# Setup development environment
direnv allow # Sets up Python venv and pre-commit
npm install
# Build the project
npm run build
# Run the server (no authentication)
npm run serve
# Run with token authentication
npm run serve:auth
# Run smoke tests
npm run test:smoke
문서 맵
예시
examples/
디렉토리에는 다음과 같은 서버 구현 사례가 포함되어 있습니다.
- 메모리 서버: 메모리에 지식 그래프를 저장하는 간단한 MCP 서버
- 에코 서버: 요청을 다시 에코하는 기본 MCP 서버
- HTTP 에코 서버: HTTP/SSE 전송을 사용하여 통신하는 MCP 서버
다음을 사용하여 예제를 실행하세요.
# STDIO-based servers
npm run memory-server
npm run echo-server
# HTTP/SSE-based server
npm run http-echo-server
# Client examples
npm run echo-client # Connect to STDIO Echo server
npm run memory-client # Connect to STDIO Memory server
npm run http-echo-client # Connect to HTTP/SSE Echo server
특허
MIT