Skip to main content
Glama
deenesjakoruzh
itsPremkumar

mcp-agent-mesh

by itsPremkumar
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

mcp-agent-mesh

Mesh-шлюз для MCP — позволяет одному MCP-клиенту обращаться к N MCP-серверам с маршрутизацией на основе префиксов, проверками здоровья, автоматическим переключением при отказе (circuit breaker) и единой конечной точкой как через stdio, так и через Streamable HTTP.

Что он делает

mcp-agent-mesh объединяет несколько вышестоящих MCP-серверов за одним логическим MCP-сервером. Каждый инструмент вышестоящего сервера доступен под префиксом server_name.tool_name, поэтому клиент, подключающийся к mesh-шлюзу, видит единый tools/list, содержащий инструменты всех работоспособных вышестоящих серверов.

Когда вызов инструмента завершается ошибкой и circuit breaker сервера размыкается, mesh-шлюз автоматически переключается на настроенные серверы-реплики, прежде чем вернуть ошибку клиенту.

Related MCP server: mcp-0ne

Возможности

Возможность

Описание

Агрегация

tools/list объединяет инструменты всех вышестоящих серверов в единый плоский список

Префиксная маршрутизация

Вызовите math.add — и mesh-шлюз направит запрос на сервер math

Circuit breaker

Индивидуальный circuit breaker для каждого сервера с настраиваемым порогом и таймаутом

Проверка здоровья

Фоновый цикл ping обнаруживает ранние сбои вышестоящих серверов

Переключение при отказе

Настраиваемые группы переключения позволяют алиасам подменять отказавший сервер

Двойной транспорт

Работает как stdio MCP-сервер и как Streamable HTTP-сервер

Таймауты и повторы

Каждый вышестоящий вызов обёрнут в asyncio.wait_for

Архитектура

                     ┌─────────────────────┐
  MCP client ───────►│   MeshGateway       │
                     │   (stdio / HTTP)    │
                     └────────┬───────────┘
                              │ tools/list
                              │ tools/call
                    ┌─────────┼─────────────┐
                    ▼         ▼             ▼
               ┌────────┐ ┌─────────┐ ┌─────────┐
               │ Server │ │ Server  │ │ Server  │
               │  "A"   │ │  "B"   │ │  "C"   │   (upstream MCP servers)
               └────────┘ └─────────┘ └─────────┘

Модули

Модуль

Ответственность

config.py

Разбор YAML-конфигурации — ServerConfig, MeshConfig

health.py

Индивидуальный CircuitBreaker для сервера + ServerHealthMonitor (фоновый ping)

router.py

Префиксная маршрутизация (server.tool), разрешение групп переключения, реестр инструментов

gateway.py

MeshGateway — подключение к вышестоящим серверам, агрегация списков инструментов, маршрутизация вызовов, обслуживание MCP через stdio + HTTP

Установка

pip install -e ".[dev]"

Использование

CLI (режим stdio)

mcp-agent-mesh --config examples/mesh.yaml --transport stdio

Режим HTTP

mcp-agent-mesh --config examples/mesh.yaml --transport http --host 0.0.0.0 --port 8000

Как клиентская конфигурация (Claude Code / Codex / OpenCode)

{
  "mcpServers": {
    "mesh": {
      "command": "mcp-agent-mesh",
      "args": ["--config", "/path/to/mesh.yaml", "--transport", "stdio"]
    }
  }
}
{
  "mcpServers": {
    "mesh": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Конфигурация

Полный пример см. в examples/mesh.yaml. Ключевые поля:

servers:
  - name: math            # tool-name prefix
    transport: stdio       # "stdio" or "http"
    command: python        # stdio: how to spawn
    args: ["-m", "..."]
    url: http://...        # http: endpoint URL
    timeout: 30.0
    circuit_breaker_threshold: 3
    circuit_breaker_timeout: 300.0

failover_groups:
  math: [math_backup]      # failover aliases for the "math" server

Тестирование

pytest tests/ -v

Тестовый набор использует резидентные фейковые MCP-серверы (без реальных субпроцессов) и покрывает разбор конфигурации, логику circuit breaker, префиксную маршрутизацию, агрегацию инструментов, переключение при отказе и сквозное поведение шлюза.

Лицензия

MIT

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • mcp-0ne

    ahostbr
    A
    license
    Not graded
    quality
    C
    maintenance
    A standalone MCP gateway that multiplexes multiple backend MCP servers behind a single endpoint, supporting both HTTP and stdio transports. It allows users to dynamically manage backends at runtime and organizes tools using a configurable namespace prefix.
    MIT

  • mcpstead

    ahkohd
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP Gateway that aggregates multiple upstream MCP servers into a single endpoint with persistent connections, tool registry, and authentication.
    45
    2
    MIT

  • OmniMCP Router

    Simonc44
    A
    license
    Not graded
    quality
    B
    maintenance
    A universal MCP gateway that aggregates multiple MCP servers into a single endpoint, providing features like hot-reload, auto-healing, and a hook system for request/response mutation.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Supabase

    MCP server for interacting with the Supabase platform

  • Arcjet

    An MCP server for Arcjet - the runtime security platform that ships with your AI code.

  • Appcircle MCP

    MCP server for Appcircle mobile CI/CD platform.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/itsPremkumar/mcp-agent-mesh'

If you have feedback or need assistance with the MCP directory API, please join our Discord server