Atrax

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

Atraxは、複数のMCPサーバーを集約し、統一インターフェースで提供するプロキシです。名前は漏斗網蜘蛛に由来し、複数のサーバーからのリソースを一点に集約する機能を象徴しています。

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

✨ 主な機能

• リソース集約：複数のサーバーのリソースを結合し、設定可能な衝突解決機能付き
• 透過的なプロキシ：クライアントに統一されたMCPサーバーインターフェースを提供
• プロトコル準拠：MCPプロトコル仕様を厳密に遵守
• モジュール化設計：コンポーネント間に明確な役割分担があります
• 複数のトランスポートタイプ：STDIO、HTTP/SSE、Dockerトランスポートをサポート
• 強化されたエラー処理：コンテキスト情報付きの詳細なエラーレポート
• Web統合：HTTP/SSEトランスポートを使用したブラウザおよびWebベースのクライアント
• 認証サポート：トークンベースの認証により、サーバーへのアクセスを保護

🚀 クイックスタート

# リポジトリをクローンする
git clone https://github.com/yourusername/atrax.git
cd atrax

# 開発環境を設定する
direnv allow  # Python仮想環境とpre-commitを設定
npm install

# プロジェクトをビルドする
npm run build

# サーバーを実行する（認証なし）
npm run serve

# トークン認証付きで実行する
npm run serve:auth

# スモークテストを実行する
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：バージョン管理ガイド

💻 使用例

基本的な使用法

# リポジトリをクローンする
git clone https://github.com/yourusername/atrax.git
cd atrax

# 開発環境を設定する
direnv allow  # Python仮想環境とpre-commitを設定
npm install

# プロジェクトをビルドする
npm run build

# サーバーを実行する（認証なし）
npm run serve

高度な使用法

# トークン認証付きで実行する
npm run serve:auth

# スモークテストを実行する
npm run test:smoke

examples/ ディレクトリには、サンプルサーバーの実装が含まれています。

• メモリサーバー：知識グラフがメモリに格納される単純なMCPサーバー
• エコーサーバー：リクエスト内容を返す基本的なMCPサーバー
• HTTPエコーサーバー：HTTP/SSEトランスポートを使用して通信するMCPサーバー

# STDIOベースのサーバー
npm run memory-server
npm run echo-server

# HTTP/SSEベースのサーバー
npm run http-echo-server

# クライアントの例
npm run echo-client      # STDIOエコーサーバーに接続する
npm run memory-client    # STDIOメモリサーバーに接続する
npm run http-echo-client # HTTP/SSEエコーサーバーに接続する

📄 ライセンス

MIT