Wanaku - A MCP Router that connects everything

Wanaku — 面向 AI Agent 的受治理操作代理

Wanaku 是面向 AI Agent 的受治理操作代理。它位于 Agent 与其操作的系统之间，拦截 Model Context Protocol (MCP) 工具调用、Agent 间消息以及推理 流量。在 0.2.0 版之前，该项目名为 Wanaku MCP Router。随着项目范围扩大，它更名为 Wanaku Governed Execution Proxy。

Wanaku 支持 AI Agent 的开放标准，并与企业框架提供一流的集成支持， 包括 Apache Camel 和 Quarkus。例如，集成 开发者可以构建 Apache Camel 路由，并使用 Wanaku 的 Camel Integration Capability 将其发布为工具。Agent 使用参数调用这些工具，但实际工作由 Wanaku 执行。Agent 绝不会直接访问后端 系统。代理负责执行策略、身份验证、数据控制和审计要求。

该项目名称源自 guanaco 一词的词源，这种骆驼科动物原产于南美洲。

主要功能

• Agent 隔离 — Agent 通过 Wanaku 调用工具；它们绝不会直接访问后端系统
• 策略执行 — 由大模型驱动的评估器和 WASM 操作脚本在代理层对工具调用进行分类、过滤和拦截
• 身份与身份验证 — 通过 oauth2-proxy 和 Keycloak 进行身份验证与授权，并在操作到达后端之前执行
• 工具发现 — 自动发现上游 MCP 服务中的工具；集成开发者可将 Camel 路由发布为工具
• 命名空间隔离 — 按团队、租户或环境，将工具和资源整理到彼此隔离的命名空间中
• 可扩展架构 — 通过功能 crate 和可组合的过滤器管道实现插件系统
• 管理面板 — 用于管理工具、资源、提示词和转发的 Web 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 参考
• 管理界面 - 管理仪表盘开发
• 功能 / 插件 - 功能 crate 系统
• 插件目录 - 发布和配置可用的 UI 插件
• 插件开发 - 编写新功能 crate 的指南
• 评估器引擎 - 基于 WASM 的评估器
• 操作策略 - 确定性 MCP 操作规则
• 治理态势 - 执行模式和故障安全行为
• 贡献指南 - 贡献指南
• 安全 - 安全策略

社区

• GitHub Issues - 错误报告和功能请求
• 讨论区 - 提问和分享想法

相关项目

• Wanaku Barn — Wanaku 项目的实用工具：OpenShift/Kubernetes 操作器、CLI 客户端等
• Camel 集成能力 — 构建 Apache Camel 路由，并将其发布为 Agent 可通过 Wanaku 调用的工具

许可证

本项目采用 Apache 2.0 许可证授权，详情请参阅 LICENSE 文件。