MCP Tools
23 программных инструмента (vault, tasks, intelligence, memory, workflows, agents, communication profiles)
MCP Tools
MCP-сервер dev-workflow предоставляет 23 tools. Конфигурируется в .mcp.json при dev-workflow init.
Vault
| Tool | Параметры | Описание |
|---|---|---|
vault_status | -- | Полное состояние vault одним вызовом |
vault_read | section: stack|conventions|knowledge|gameplan | Прочитать секцию vault |
vault_search | query: string | Поиск по всем vault-файлам |
vault_record | type: adr|bug|debt, title, content | Создать запись |
vault_knowledge | section: string, content: string | Дописать в knowledge.md |
vault_pattern | section?: string, content: string | Дописать pattern-bullet в conventions.md (по умолчанию section = "Patterns") |
vault_status
Агрегированное состояние проекта — одним вызовом вместо 4+ отдельных reads:
{
"project": "my-project",
"branch": "feature/auth",
"sections": {
"stack": { "filled": true, "lines": 45 },
"conventions": { "filled": true, "lines": 82 },
"knowledge": { "filled": false, "lines": 6 },
"gameplan": { "filled": true, "lines": 38 }
},
"tasks": { "total": 5, "pending": 2, "in-progress": 1, "done": 2 },
"workflow": null,
"intelligence": { "patterns": 47, "edges": 23 }
}Используется в /vault:from-spec Step 2, /session:resume, /workflow:dev Step 1.
Задачи
| Tool | Параметры | Описание |
|---|---|---|
task_create | title, description? | Создать задачу |
task_list | status? | Список задач с фильтром |
task_update | id, status?, description? | Обновить задачу |
task_start | id | Старт: in-progress + привязка к ветке task/<slug> |
task_create_from_phase | phaseFile | Парсит ## Tasks из файла фазы, создаёт недостающие |
task_start
Бизнес-логика: меняет статус на in-progress, генерирует slug из названия задачи, привязывает к ветке:
{
"id": "task-001",
"title": "Add email validation",
"status": "in-progress",
"branch": "task/add-email-validation"
}Intelligence
| Tool | Параметры | Описание |
|---|---|---|
intelligence_query | branch?, task?, limit? | Поиск паттернов с scoring |
Возвращает массив паттернов, ранжированных по трём критериям:
- Recency — давность последнего доступа (half-life 7 дней)
- Frequency — частота использования
- Context match — совпадение с текущей веткой и задачей
[
{ "id": "file:src/auth.ts", "category": "file", "content": "...", "score": 0.87 },
{ "id": "session:2026-04-01", "category": "session", "content": "...", "score": 0.62 }
]Memory (Engram proxy)
| Tool | Параметры | Описание |
|---|---|---|
memory_search | query, limit?, tags? | Поиск Engram воспоминаний с auto-decoration (step/branch/run/task теги активного pipeline автоматически добавляются к фильтру) |
memory_store | context, action, result, type, tags? | Сохранить воспоминание с auto-decoration. Engram раскладывает контент на context/action/result. Ошибки daemon (Voyage 403, offline, и т. д.) поднимаются вызывающему агенту через JSON-RPC isError: true |
memory_judge | memory_id, score: 0.0–1.0, explanation? | Оценить полезность воспоминания. Питает Q-learning router для адаптивного отбора контекста |
Auto-decoration
В отличие от прямого mcp__engram__memory_*, прокси-обёртки автоматически добавляют теги активного pipeline-контекста: step:<имя шага>, branch:<текущая ветка>, run:<run-id>, task:<task-id>. Агенты могут фильтровать воспоминания по фазе исполнения без ручного тегирования. Прямой mcp__engram__memory_* остаётся escape hatch для случаев, когда нужен явный контроль над project / tags.
Asymmetry: strict vs silent (ADR 2026-05-06)
- User-invoked
mcp__dev-workflow__memory_store— throws daemon errors. Если Voyage недоступен или ключ ротирован, агент видит сообщение в tool-result и может реагировать (свитчнуть provider, рестартнуть daemon). - Auto-mirror (
vault_record/vault_knowledge/vault_pattern/EngramBridge.afterStep) — silent fail-safe. Vault-файл — единственный источник правды; mirror — secondary.
Workflow и агенты
| Tool | Параметры | Описание |
|---|---|---|
workflow_status | runId? | Статус текущего/указанного workflow run |
workflow_create | name, yaml | Сохранить кастомный workflow в .dev-vault/workflows/ |
agent_list | -- | Список агентов с permissions |
agent_run | agent, task | Генерация промпта агента с vault-контекстом |
parse_engram_feedback | output: string | Парсинг блока ## Engram Feedback из вывода агента (для пайплайнового scoring) |
Communication profiles
3 tools для управления активным профилем общения (см. Communication Profiles).
| Tool | Параметры | Описание |
|---|---|---|
profile_get | -- | Snapshot: {configured, active, default, effective, available, config}. Active = из .profile-state (или null), default = из yaml active_profile, effective = active ?? default. |
profile_set | name: string | Validate name существует в communication.yaml profiles map (через Object.prototype.hasOwnProperty.call — защита от prototype pollution) → write .dev-vault/.profile-state. |
profile_clear | -- | Удалить .dev-vault/.profile-state (no-op если file отсутствует). После clear getActiveProfile fallback на yaml-default. |
Slash /profile (см. commands/session) — thin wrapper над этими tools. Прямой вызов через MCP полезен для CLI-скриптов / automation.
Где конфигурируется
MCP-сервер настраивается в .mcp.json (не в .claude/settings.json):
{
"mcpServers": {
"dev-workflow": {
"command": "node",
"args": ["/absolute/path/to/dist/cli/index.js", "serve"]
}
}
}Claude Code автоматически обнаруживает .mcp.json в корне проекта.