Легкий, настраиваемый обратный прокси для маршрутизации и балансировки нагрузки MCP (Model Context Protocol) запрашивает соответствующие бэкэнд-сервисы на основе содержимого запроса.

Для получения подробной документации посетите Catie MCP Documentation.

Особенности

Динамическая маршрутизация запросов MCP JSON-RPC на основе вызова инструмента Сопоставьте инструменты из нескольких разных MCP-серверов, чтобы клиент получил единое представление обо всех инструментах без установки пользователем нескольких серверов.

• Сессионно-ориентированная маршрутизация для поддержания клиентских соединений с одним и тем же бэкэндом Поддержка потоковой передачи HTTP с помощью SSE (Server-Sent Events) Картирование имен и имен для разрешения конфликтов имен между различными бэкэндами Интеграция метрик Прометея для наблюдаемости Контейнерное развертывание с Docker Базовая аутентификация для мониторинга UI

Архитектура

Приложение структурировано в несколько пакетов:

• cmd/main.go - точка входа приложения с настройкой сервера
• [[Т1]] - Загрузка и управление конфигурацией
• pkg/router - Запрос маршрутизации и прокси-логика pkg/session - Управление сеансами для поддержания клиентских связей
• [[Т4]] - Структурированная лесозаготовительная система

MCP Catie - Context Aware Traffic Ingress Engine

A lightweight, configurable reverse proxy for routing and load balancing MCP (Model Context Protocol) requests to appropriate backend services based on request content.

For detailed documentation, visit Catie MCP Documentation.

Features

• Dynamic routing of MCP JSON-RPC requests based on tool call
• Concatenate tools from multiple different MCP Servers so the client gets a unified view of all tools without the user installing multiple servers.
• Session-aware routing to maintain client connections to the same backend
• Support for Streamable HTTP transport with SSE (Server-Sent Events)
• Tool name mapping and namespacing to resolve naming conflicts between different backends
• Prometheus metrics integration for observability
• Containerized deployment with Docker
• Basic authentication for monitoring UI

Architecture

The application is structured into several packages:

• cmd/main.go - Application entry point with server setup
• pkg/config - Configuration loading and management
• pkg/router - Request routing and proxy logic
• pkg/session - Session management for maintaining client connections
• pkg/logger - Structured logging system
• pkg/ui - Simple web UI for monitoring

Configuration

The router is configured using a YAML file (router_config.yaml). Here’s an example configuration:

resources:
  "^weather/.*": "http://weather-service:8080/mcp"
  "^database/.*": "http://database-service:8080/mcp"
tools:
  "^calculator$": "http://calculator-service:8080/mcp"
  "^translator$": "http://translator-service:8080/mcp"
toolMappings:
  - originalName: "weather"
    targetName: "getWeather"
    target: "http://weather-service:8080/mcp"
  - originalName: "search"
    targetName: "googleSearch"
    target: "http://search-service:8080/mcp"
default: "http://default-service:8080/mcp"
ui:
  username: "admin"
  password: "your_secure_password"

The configuration consists of:

• resources: Regex patterns for resource URIs and their target endpoints
• tools: Regex patterns for tool names and their target endpoints
• toolMappings: Mappings for tool name transformations to resolve naming conflicts
• default: Fallback endpoint for requests that don’t match any pattern
• ui: Authentication credentials for the monitoring UI

The configuration file is automatically reloaded when changes are detected.

Tool Name Mapping

The tool name mapping feature allows you to present a unified tool interface to clients while handling naming differences across backend MCP servers. This is useful when:

• Different backends use different names for similar functionality
• You want to present a simplified or standardized naming scheme to clients
• You need to avoid naming conflicts between tools from different backends

For each tool mapping, specify:

• originalName: The name presented to clients