Wanaku - A MCP Router that connects everything

Wanaku — AI エージェント向けのガバナンス付きアクションプロキシ

Wanaku は、AI エージェント向けのガバナンス付きアクションプロキシです。エージェントと、エージェントが操作するシステムの間に位置し、 Model Context Protocol（MCP）のツール呼び出し、エージェント間メッセージ、推論トラフィックを 仲介します。バージョン 0.2.0 より前は、このプロジェクトは Wanaku MCP Router という名称でした。対象範囲の拡大を反映するため、Wanaku Governed Execution Proxy に改称しました。

Wanaku は AI エージェント向けのオープン標準をサポートし、 Apache Camel や Quarkus などのエンタープライズフレームワークと 緊密に統合します。たとえば、インテグレーション開発者は Apache Camel ルートを構築し、Wanaku の Camel Integration Capability を使用して、それらをツールとして公開します。エージェントはパラメーターを指定してツールを呼び出しますが、実際の処理は Wanaku が実行します。エージェントがバックエンドシステムに直接アクセスすることはありません。プロキシがポリシー、ID、データ制御、監査要件を適用します。

プロジェクト名は、南米原産のラクダ科動物であるグアナコの由来にちなんでいます。

主な機能

• エージェントの分離 — エージェントは Wanaku 経由でツールを呼び出します。バックエンドシステムに直接アクセスすることはありません
• ポリシーの適用 — LLM を活用した評価器と WASM アクションスクリプトが、プロキシ層でツール呼び出しを分類、フィルタリング、ブロックします
• ID と認証 — oauth2-proxy と Keycloak による認証と認可を、アクションがバックエンドに到達する前に適用します
• ツールの検出 — 上流の MCP サーバーからツールを自動検出します。インテグレーション開発者は Camel ルートをツールとして公開できます
• 名前空間の分離 — チーム、テナント、または環境ごとに分離された名前空間でツールとリソースを整理できます
• 拡張可能なアーキテクチャ — 機能クレートによるプラグインシステムと、組み合わせ可能なフィルターパイプラインを備えています
• 管理ダッシュボード — ツール、リソース、プロンプト、フォワードを管理するウェブ UI
• コンテナー対応 — マルチアーキテクチャイメージ（x86_64、aarch64）を自動公開します

クイックスタート

インストール

Linux または macOS 向けの最新の早期アクセスビルドをダウンロードします。早期アクセスビルドは、未リリースの Wanaku 0.3.0 の開発ビルドです。これは、このサーバーの最初の安定版リリースです。変更の頻度を抑えたい場合は、リリースページでリリースを確認してください。

curl -fsSL https://raw.githubusercontent.com/wanaku-ai/wanaku/main/get-wanaku.sh | bash

インストーラーはホストプラットフォームを検出し、リリースのチェックサムを検証して、wanaku-server を $HOME/bin にインストールします。

WANAKU_INSTALL_DIR でインストール先を変更できます。Wanaku をコンテナー内または systemd サービスとして実行するには、はじめにガイドをお読みください。

wanaku-server を実行し、http://localhost:8080 にアクセスすると、ダッシュボードが表示されます。

テキストインターフェースをご希望の場合は、Wanaku Barnプロジェクトから Wanaku CLI をダウンロードして使用することもできます。

Wanaku を学ぶ

Wanaku を学ぶ最も簡単な方法は、**ガイド付きチュートリアル**に沿って進めることです。

完全なインストールおよび設定手順を含むリファレンスドキュメントは、使用ガイドでご覧いただけます。

ドキュメント

Wanaku ドキュメント のウェブサイトには、プロジェクトのドキュメントがすべて掲載されています。

プロジェクトに取り組むコントリビューターは、開発ドキュメントも参照してください。

• はじめに - 開発環境のセットアップガイド
• アーキテクチャ - システムアーキテクチャとコンポーネント
• 設定 - 環境変数と設定リファレンス
• 管理 API - API リファレンス
• 管理 UI - 管理ダッシュボードの開発
• 機能／プラグイン - 機能クレートシステム
• プラグインカタログ - 利用可能な UI プラグインの公開と設定
• プラグイン開発 - 新しい機能クレートを作成するためのガイド
• 評価エンジン - WASM ベースの評価エンジン
• アクションポリシー - 決定論的な MCP アクションルール
• ガバナンス体制 - 適用モードとフェイルセーフ動作
• コントリビューション - コントリビューションガイドライン
• セキュリティ - セキュリティポリシー

コミュニティ

• GitHub の Issue - バグ報告や機能リクエスト
• ディスカッション - 質問やアイデアの共有

関連プロジェクト

• Wanaku Barn — Wanaku プロジェクト向けのユーティリティ：OpenShift／Kubernetes オペレーター、CLI クライアントなど
• Camel Integration Capability — Apache Camel ルートを作成し、エージェントが Wanaku 経由で呼び出せるツールとして公開します

ライセンス

このプロジェクトは Apache 2.0 ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。