DollhouseMCP/mcp-server

Аддитивные, неразрушающие операции. Поддерживаемые операции: create_element, import_element, addEntry, verify_challenge, release_deadlock, beetlejuice_beetlejuice_beetlejuice, record_execution_step, install_collection_content, submit_collection_content, init_portfolio, sync_portfolio, portfolio_element_manager, setup_github_auth, configure_oauth, import_persona Типы элементов: persona, skill, template, agent, memory, ensemble Эти операции добавляют новые данные без удаления или перезаписи существующего содержимого. Примеры быстрого старта: { operation: "create_element", element_type: "persona", params: { element_name: "MyPersona", description: "A helpful assistant", instructions: "You ARE a helpful assistant. ALWAYS provide clear, accurate responses." } } { operation: "create_element", element_type: "agent", params: { element_name: "MyAgent", description: "Task executor", instructions: "Execute goals methodically. Report progress at each step.", goal: { template: "Complete: {objective}", parameters: [{ name: "objective", type: "string", required: true }] } } } { operation: "create_element", element_type: "memory", params: { element_name: "session-notes", description: "Session context and notes" } } { operation: "create_element", element_type: "ensemble", params: { element_name: "my-ensemble", description: "Combined element set", metadata: { elements: [{ element_name: "expert", element_type: "persona", role: "primary" }, { element_name: "analysis", element_type: "skill", role: "support" }] } } } Допустимые роли ensemble: primary, support, override, monitor, core { operation: "addEntry", params: { element_name: "session-notes", content: "Remember this fact", tags: ["important"] } } Примечание: содержимое addEntry поддерживает Markdown (заголовки, списки, жирный текст, таблицы, блоки кода). Следите, чтобы Markdown-содержимое было правильно экранировано в JSON — используйте \n для переносов строк, " для кавычек и \ для обратной косой черты внутри строкового значения JSON. Жизненный цикл выполнения — записывает прогресс агента (добавляет записи шагов, например…)

Деструктивные операции, удаляющие данные. Поддерживаемые операции: delete_element, clear, clear_github_auth Типы элементов: persona, skill, template, agent, memory, ensemble Эти операции удаляют данные. Используйте с осторожностью. ⚠️ БЕЗОПАСНОСТЬ: Не разрешайте этот эндпоинт автоматически в настройках вашего хоста (например, Claude Code settings.json). Каждая операция удаления должна требовать явного подтверждения человеком. Автоматическое разрешение обходит шлюз подтверждения для каждой операции, оставляя только политики запрета элементов в качестве защиты от случайной потери данных. Примеры для быстрого старта: { operation: "delete_element", element_type: "persona", params: { element_name: "Old-Persona" } } { operation: "clear", params: { element_name: "temp-notes" } } { operation: "clear_github_auth" } Узнайте обязательные параметры: используйте mcp_aql_read: { operation: "introspect", params: { query: "operations", name: "delete_element" } }

Операции жизненного цикла выполнения для исполняемых элементов (агенты, рабочие процессы, пайплайны). Поддерживаемые операции: confirm_operation, approve_cli_permission, execute_agent, complete_execution, continue_execution, abort_execution, prepare_handoff, resume_from_handoff Эти операции управляют состоянием выполнения во время исполнения. В отличие от CRUD-операций (которые управляют определениями), операции Execute обрабатывают жизненный цикл выполнения: - execute_agent: Начинает новое выполнение (возвращает goalId и stateVersion для отслеживания) - complete_execution: Сигнализирует об успешном завершении после достижения цели - continue_execution: Возобновляет ранее приостановленное выполнение с теми же параметрами цели - abort_execution: Прерывает выполняющееся выполнение, отклоняя дальнейшие операции - confirm_operation: Подтверждает ожидающую операцию, требующую одобрения пользователя (поток Gatekeeper) - approve_cli_permission: Одобряет ожидающий запрос разрешения для инструмента CLI - prepare_handoff: Сериализует прогресс цели в портативный блок handoff для переноса сессии - resume_from_handoff: Возобновляет выполнение агента из блока handoff с проверкой целостности ВАЖНО: Операции Execute потенциально разрушительны (агенты могут выполнять любые действия) и неидемпотентны (двукратный вызов execute_agent создаёт два отдельных выполнения). ⚠️ БЕЗОПАСНОСТЬ: Не авторазрешайте эту конечную точку в настройках вашего хоста (например, Claude Code settings.json). Каждое выполнение должно требовать явного одобрения человека. Авторазрешение обходит шлюз подтверждения на каждую операцию. Хотя проверка DangerZone и политики запрета элементов всё ещё обеспечивают защиту, основной контрольный пункт проверки человеком теряется. Канонический цикл: 1. Вызовите execute_agent один раз, чтобы запустить цель и получить { goalId, stateVersion, activeElements, safetyTier, ... }. 2. После каждого блока работы используйте mcp_aql_create: { operation: "record_execution_step", ... }. 3. Прочитайте record_execution_step.autonomy.continue и любые autonomy.notifications, чтобы решить, продолжить, приостановиться для человека или обработать блок gatekeeper. 4. ...

Безопасные операции только для чтения. Поддерживаемые операции: activate_element, open_portfolio_browser, open_logs, open_metrics, open_permissions, open_setup, permission_prompt, evaluate_permission, get_effective_cli_policies, get_permission_authority, get_pending_cli_approvals, search, list_elements, get_element, get_element_details, search_elements, query_elements, get_active_elements, validate_element, render, export_element, deactivate_element, introspect, get_capabilities, get_execution_state, get_gathered_data, browse_collection, search_collection, search_collection_enhanced, get_collection_content, get_collection_cache_health, portfolio_status, portfolio_config, search_portfolio, search_all, check_github_auth, oauth_helper_status, dollhouse_config, convert_skill_format, get_build_info, get_cache_budget_report, query_logs, query_metrics, find_similar_elements, get_element_relationships, search_by_verb, get_relationship_stats Типы элементов: persona, skill, template, agent, memory, ensemble Эти запросы только читают данные и никогда не изменяют состояние сервера. Примеры для быстрого старта: { operation: "list_elements", element_type: "persona" } { operation: "get_active_elements", element_type: "persona" } { operation: "search_elements", params: { query: "creative" } } { operation: "get_element", element_type: "memory", params: { element_name: "session-notes" } } Операции с элементами: { operation: "activate_element", element_type: "persona", params: { element_name: "Default" } } { operation: "deactivate_element", element_type: "persona", params: { element_name: "Default" } } { operation: "get_element_details", element_type: "skill", params: { element_name: "code-review" } } { operation: "query_elements", element_type: "persona", params: { filters: { category: "creative" } } } { operation: "validate_element", element_type: "agent", params: { element_name: "task-planner" } } { operation: "render", params: { element_name: "meeting-notes", variables: { date: "2026-03-03" } } } { operation:…

Операции изменения, которые перезаписывают данные. Поддерживаемые операции: edit_element, upgrade_element Типы элементов: persona, skill, template, agent, memory, ensemble Эти операции изменяют существующие данные и могут перезаписывать предыдущие значения. Примечание: Память (Memories) поддерживает только добавление записей и не поддерживает edit_element. Используйте addEntry (CREATE) для добавления новых записей. Пример для быстрого старта: { operation: "edit_element", element_type: "persona", params: { element_name: "MyPersona", input: { description: "Updated description" } } } { operation: "edit_element", element_type: "persona", params: { element_name: "Friendly-Teacher", input: { instructions: "Updated behavioral directives." } } } { operation: "edit_element", element_type: "agent", params: { element_name: "code-reviewer", input: { instructions: "Updated agent behavioral profile.", goal: { template: "Complete: {task}" } } } } { operation: "upgrade_element", element_type: "agent", params: { element_name: "task-planner" } } Чтобы узнать необходимые параметры — используйте mcp_aql_read: { operation: "introspect", params: { query: "operations", name: "edit_element" } }