README Documentation
Wanaku - A MCP Router that connects everything
The Wanaku MCP Router is a router for AI-enabled applications powered by the Model Context Protocol (MCP).
This protocol is an open protocol that standardizes how applications provide context to LLMs.
The project name comes from the origins of the word Guanaco, a camelid native to South America.
Key Features
- Unified Access - Centralized routing and resource management for AI agents
- MCP-to-MCP Bridge - Act as a gateway or proxy for other MCP servers
- Extensive Connectivity - Leverage 300+ Apache Camel components for integration
- Secure by Default - Built-in authentication and authorization via Keycloak
- Kubernetes-Native - First-class support for OpenShift and Kubernetes deployments
- Extensible Architecture - Easy to add custom tools and resource providers
- Multi-Namespace Support - Organize tools and resources across isolated namespaces
Quick Start
Wanaku CLI Installation
Note: Java 21 or later is required to run Wanaku.
# Install via JBang (requires Java 21+)
jbang app install wanaku@wanaku-ai/wanaku
# Or download the latest binary from releases
# https://github.com/wanaku-ai/wanaku/releases
Basic Usage
# Authenticate with your Wanaku router
wanaku auth login --url http://localhost:8080
# List available tools
wanaku tools list
# Add a new tool
wanaku tools add --uri http://example.com/api --service http
# List available resources
wanaku resources list
For complete installation and configuration instructions, see the Usage Guide.
Documentation
For most users, the Wanaku Documentation website is the recommended starting point. It covers installation, configuration, and usage for stable releases.
The documentation below is intended for developers working on the project and may reference unreleased features or in-progress changes:
- Usage Guide - Installation, deployment, and CLI usage
- Architecture - System architecture and components
- Building - Build and package the project
- Contributing - Contribution guidelines
- Configuration - Configuration reference
- Security - Security policy and best practices
Community
- GitHub Issues - Bug reports and feature requests
- Discussions - Ask questions and share ideas
- Examples - Example capabilities and integrations
License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.