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 — разрушающее чтение буфера.
Настройка клиентов
{
"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 для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
MCP-сервер для анализа сбоев в WinDbg
Анализ аварийных дампов Windows через WinDbg и CDB.