aimdb-mcp

aimdb-mcp — MCP-сервер сообщества (автор — aimdb-dev). Инспекция и отладка узлов AimDB. Лицензия Apache-2.0.

Опубликовано 14.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
aimdb-dev
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
rust

Уровень риска: high

С флагом --allow-writes меняет значения записей и сбрасывает счётчики живых экземпляров AimDB; drain_record — разрушающее чтение буфера.

Настройка клиентов

vscode
{
    "code": "{\n  \"servers\": {\n    \"aimdb\": {\n      \"type\": \"stdio\",\n      \"command\": \"/path/to/aimdb-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"RUST_LOG\": \"info\"\n      }\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "notes": "Укажите путь к собранному бинарнику",
    "verified": "docs"
}

Что умеет

aimdb-mcp — MCP-сервер для AimDB, который даёт языковой модели исследовать, отлаживать и мониторить запущенные экземпляры AimDB на естественном языке. Сервер работает по stdio (JSON-RPC 2.0, формат NDJSON) и подключается к экземплярам через Unix-сокеты, а при сборке с функцией transport-serial — и через последовательный порт.

13 инструментов:

  • discover_instances — находит запущенные экземпляры: пути сокетов, версии, число записей;
  • get_instance_info — версия сервера, протокол, права, возможности, а с протокола 3.1 ещё имя, UID и данные сборки;
  • list_records — записи экземпляра: имена, типы, настройки буферов, число производителей и потребителей, объявленная схема (schema_type, schema_version);
  • get_record — текущее значение записи в виде {value, ts};
  • set_record — запись значения (только с --allow-writes);
  • drain_record — забирает все значения с прошлого вызова; это разрушающее пакетное чтение, первый вызов возвращает пустой результат;
  • graph_nodes, graph_edges, graph_topo_order — граф зависимостей записей: узлы, направленные рёбра потока данных, порядок инициализации;
  • get_stage_profiling и reset_stage_profiling — время каждого этапа .source(), .tap(), .link() и поиск узкого места (нужна функция profiling);
  • get_buffer_metrics и reset_buffer_metrics — счётчики произведённых, потреблённых и потерянных значений и заполненность буфера (нужна функция metrics).

Режимы. По умолчанию доступны 10 инструментов только для чтения. --allow-writes добавляет set_record, reset_stage_profiling и reset_buffer_metrics. Режим --public для недоверенных публичных точек оставляет только discover_instances, list_records и get_record и важнее --allow-writes; в нём адрес из запроса клиента отбрасывается, чтобы нельзя было перебирать пути на хосте. Политика безопасности AimX самого экземпляра продолжает действовать: экземпляр с SecurityPolicy::read_only() отклоняет запись даже с --allow-writes.

Ресурсы и подсказки. Ресурсы aimdb://instances, aimdb://instance/... и список записей экземпляра; подсказка troubleshooting для диагностики подключения и записей. Сервер не выводит схемы сам — README советует опираться на объявленный контракт записи и реальное значение.

Кому подойдёт

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

Похожие серверы — в категории базы данных.

Установка

Сервер собирается из исходников командой cargo build --release -p aimdb-mcp; бинарный файл появится в target/release/aimdb-mcp. Целевой экземпляр выбирается аргументом endpoint в инструменте, флагом --connect при запуске или переменной AIMDB_CONNECT — именно в таком порядке. Для пробы есть пример examples/remote-access-demo: cargo run создаёт экземпляр /tmp/aimdb-demo.sock с тестовыми записями.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "servers": {
    "aimdb": {
      "type": "stdio",
      "command": "/path/to/aimdb-mcp",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

В VS Code файл — .vscode/mcp.json в рабочей папке, он подхватывается автоматически. В Claude Desktop — claude_desktop_config.json.

Проверка

Спросите: «Какие экземпляры AimDB запущены?» — сработает discover_instances.

Примеры задач

Какой этап конвейера Temperature — узкое место?
Как данные проходят между записями?

Риски

  • Изменение живой системы. С --allow-writes ассистент меняет значения записей и сбрасывает счётчики. README советует включать флаг только там, где агенту действительно можно менять систему.
  • Разрушающее чтение. drain_record забирает накопленные значения буфера.
  • Публичный доступ. Для недоверенных клиентов используйте --public.

Частые вопросы

Может ли ассистент менять данные по умолчанию?

Нет, set_record и сбросы счётчиков доступны только с --allow-writes.

Как не передавать путь к сокету каждый раз?

Закрепите экземпляр флагом --connect или переменной AIMDB_CONNECT.

Почему нет данных профилирования?

Экземпляр должен быть собран с функцией profiling.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники