MCP Nexus

MCP Nexus — это локально-ориентированный интеллектуальный маршрутизатор для Model Context Protocol. Ваша ИИ-среда подключается к одной конечной точке MCP — Nexus, — в то время как Nexus управляет всеми вашими реальными MCP-серверами за кулисами: индексирует их инструменты, обнаруживает возможности по запросу, запускает серверы лениво, выполняет маршрутизированные вызовы и учится на локальном использовании, чтобы со временем лучше ранжировать результаты.

Before                                With MCP Nexus

AI Harness                            AI Harness
  ├── GitHub MCP   (30 tools)           └── mcp-nexus (4 control tools)
  ├── Jira MCP      (25 tools)              ├── search_capabilities
  ├── Slack MCP     (20 tools)              ├──── describe_capabilities
  ├── Figma MCP     (18 tools)              ├──── execute_capability
  ...                                   └──── search_servers
  ~90+ tool schemas in context                  │
                                     (everything else stays indexed
                                      on disk until actually needed)

Зачем

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

Nexus переворачивает модель: вместо того чтобы помещать каждую нижестоящую схему в контекст, он хранит легковесный индекс возможностей на диске и предоставляет крошечную плоскость управления. Агент обнаруживает возможности по мере необходимости (search_capabilities), просматривает точные схемы только для выбранного (describe_capabilities) и выполняет через Nexus (execute_capability). Все состояние — конфигурация, индекс, аналитика, изученные последовательности — хранится локально в .mcp-nexus/.

Related MCP server: Master MCP Server

Быстрый старт

# 1. Scaffold a project config
npx @fyrlabs/mcp-nexus init

# 2. Add downstream MCP servers (anything runnable over stdio)
npx @fyrlabs/mcp-nexus add github -- npx -y @modelcontextprotocol/server-github
#    or import an existing config:
npx @fyrlabs/mcp-nexus import --from claude

# 3. Point your harness at Nexus (see docs/harness-setup.md)

Конфигурация среды (Claude Code, Cursor, Codex и другие MCP-клиенты):

{
  "mcpServers": {
    "mcp-nexus": {
      "command": "npx",
      "args": ["-y", "@fyrlabs/mcp-nexus"]
    }
  }
}

Nexus автоматически находит project-mcp.json, поднимаясь от рабочего каталога, или передайте --config ./path/to/nexus.json.

Затем, с точки зрения агента:

search_capabilities  { "query": "find comments people left on my PR" }
→ github.review_comments.list  score=0.94 ...

describe_capabilities { "capabilityIds": ["github.review_comments.list"] }
→ exact input schema

execute_capability   { "capabilityId": "github.review_comments.list",
                       "arguments":  { ... } }
→ forwarded verbatim to the right server, started on demand

Что раскрывается, а что остается скрытым

Основные возможности

• Локально-ориентированный. Никакого облачного сервиса, аккаунта или телеметрии. Удалите .mcp-nexus/ — и все изученное состояние исчезнет.

• Ленивый жизненный цикл. Нижестоящие серверы запускаются только когда задача требует их, и останавливаются после многоуровневых тайм-аутов простоя (горячий / теплый / холодный).

• Гибридный поиск. Лексическое ранжирование BM25 по взвешенным полям, точное совпадение id/инструмента, расширение алиасов (pr → pull request, настраивается) и подключаемый интерфейс EmbeddingProvider для опциональных семантических слоев.

• Адаптивное ранжирование с пояснениями. Каждый результат содержит разбивку сигналов; закрепленные возможности превосходят изученную популярность; заблокированные возможности никогда не предлагаются.

• Предсказание последовательностей. Повторяющиеся переходы инструментов изучаются локально и используются для повышения вероятных следующих возможностей — предсказание никогда не выполняется автоматически.

• Ноль нативных зависимостей. Хранилище использует встроенный node:sqlite из Node; установка этого пакета ничего не компилирует.

• Независимость от среды. Все, что говорит на MCP stdio, может стоять перед Nexus.

Требования

• Node.js >= 22.5 (рекомендуется 24 LTS)

Документация

• Справочник по конфигурации — каждое поле, порядок разрешения, подстановка env

• Справочник по CLI — все команды и флаги

• Архитектура — модули, модель оценки, схема хранилища

• Настройка среды — Claude Code, Cursor, Codex, универсальные MCP-клиенты

• examples/project-mcp.json — аннотированный стартовый конфиг

Разработка

git clone https://github.com/fyrlabs/mcp-nexus && cd mcp-nexus
npm install
npm run build       # tsc -> dist/
npm run test        # vitest (unit + integration, mirrors src/ structure under src/tests/)
npm run typecheck   # strict tsc, no emit
npm run lint        # eslint

Интеграционные тесты запускают реальный пакет @modelcontextprotocol/server-everything в качестве нижестоящего stdio-сервера и маршрутизируют выполнение через полный рантайм — они автоматически пропускаются, если пакет не может быть разрешен.

Смотрите AGENTS.md для соглашений о вкладе (коммиты, версионирование, структура).

Конфиденциальность

Nexus хранит кэши конфигурации, индексы и аналитику в .mcp-nexus/ (или в вашей XDG-директории данных). Сам маршрутизатор ничего никуда не отправляет. Если вы настроите внешнего провайдера эмбеддингов, туда будут отправляться только тексты возможностей (названия/описания/ключевые слова) — никогда аргументы, секреты или аналитика. Сырые аргументы инструментов никогда не сохраняются.

Лицензия

Apache-2.0