Atrax: MCP 서버 집계 프록시 v0.1.0

지엑스피1

사전 커밋

Atrax는 여러 대의 MCP 서버를 통합하여 단일 통합 인터페이스로 제공하는 MCP(Model Context Protocol) 서버용 프록시입니다. 이름은 "깔때기 모양의 거미줄"에서 유래되었으며, 여러 서버의 리소스를 하나로 모으는 방식을 나타냅니다.

특징

리소스 집계 : 구성 가능한 충돌 해결을 통해 여러 서버의 리소스를 결합합니다.
투명 프록싱 : 클라이언트에게 통합된 MCP 서버 인터페이스를 제공합니다.
프로토콜 준수 : MCP 프로토콜 사양을 엄격히 준수합니다.
모듈형 디자인 : 구성 요소 간의 관심사를 명확하게 분리
다양한 전송 유형 : STDIO, HTTP/SSE 및 Docker 전송 지원
향상된 오류 처리 : 상황에 맞는 정보를 포함한 자세한 오류 보고
웹 통합 : 브라우저 및 웹 기반 클라이언트를 위한 HTTP/SSE 전송
인증 지원 : 서버 액세스 보안을 위한 토큰 기반 인증

Related MCP server: mcprouter

빠른 시작

# 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

문서 맵

DEVELOPMENT.md : 개발 환경 설정 및 워크플로
GUIDELINES.md : 프로젝트 가이드라인 및 코딩 표준
MCP_SDK_INTEGRATION.md : MCP SDK 통합 가이드
HTTP_SSE_TRANSPORT.md : HTTP/SSE 전송 구현 및 사용법
TOKEN_AUTH.md : 토큰 인증 가이드 및 사용법
DIRENV.md : 환경 관리를 위한 direnv 사용
CLAUDE.md : 일반적인 명령에 대한 빠른 참조
VERSION_MANAGEMENT.md : 버전 관리 지침

예시

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