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.