Atrax: MCP Server Aggregation Proxy v0.1.0

Atrax：MCP サーバー集約プロキシ v0.1.0

              .  .               __
             .|  |.      _____ _/  |_____________  ___  ___
             ||  ||      \__  \\   __\_  __ \__  \ \  \/  /
             \\()//       / __ \|  |  |  | \// __ \_>    <
             .={}=.      (____  /__|  |__|  (____  /__/\_ \
            / /`'\ \          \/                 \/      \/
            ` \  / '
               `'           MCP PROXY FOR THE WEB v0.1.0

Atrax は、複数の MCP サーバーを集約し、単一の統合インターフェースとして提供する Model Context Protocol（MCP）サーバー用のプロキシです。その名前は、複数のサーバーからのリソースを 1 つに集約する仕組みを表す、ジョウゴグモに由来します。

特長

• リソースの集約：設定可能な競合解決機能を使って、複数のサーバーのリソースを統合します
• 透過的なプロキシ：統合された MCP サーバーインターフェースをクライアントに提供します
• プロトコル準拠：MCP プロトコル仕様を厳格に遵守します
• モジュール設計：コンポーネント間の関心事を明確に分離します
• 複数のトランスポートタイプ：STDIO、HTTP/SSE、Docker トランスポートをサポートします
• 強化されたエラー処理：状況に応じた詳細なエラー情報を提供します
• Web 連携：ブラウザーや Web ベースのクライアント向けに 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

ドキュメント一覧

• 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

ライセンス

MIT