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.