analyst-mcp

name	analyst-mcp
description	MCP-инструменты агента-аналитика 1С: shared и per-agent серверы, conf-doc, SearXNG web-search и document-reader.

analyst-mcp — MCP для аналитика

Человеческая документация (Docker, отладка, gating): docs/searxng.md. Конфиг env.json: docs/configuration.md.

Конфигурация (бот)

{
  "mcp_servers": {
    "conf-doc": { "...": "shared для всех агентов" }
  },
  "agents": {
    "analyst": {
      "mcp_inherit": true,
      "mcp_servers": {
        "searxng": {
          "enabled": true,
          "transport": "stdio",
          "command": "npx",
          "args": ["-y", "mcp-searxng"],
          "env": {
            "SEARXNG_URL": "http://localhost:8080"
          }
        },
        "document-reader": { "enabled": false }
      }
    }
  }
}

Merge: {...profile.mcp_servers, ...agent.mcp_servers}. enabled: false — пропуск.

Когда какой MCP

MCP	Когда	Инструменты
conf-doc	Всегда для метаданных конфигурации	conf_doc_*
searxng	Только после conf_doc + profile; не хватает имён реквизитов / OData-поведения	searxng_web_search, web_url_read
document-reader	Книги/PDF по 1С (future)	filesystem MCP

SearXNG

Fallback после conf-doc + profile. Gating: не вызывать до conf_doc_search.

Tool	Назначение
searxng_web_search	Поиск по вебу
web_url_read	Чтение страницы в markdown

Установка, Docker, MCP в Cursor, отладка 403: docs/searxng.md.

Cursor IDE

Подключи в .cursor/mcp.json:

• 1c-conf-doc — обязательно
• searxng — опционально для внешней документации
• Опционально: filesystem (document-reader)

См. mcp.analyst.example.json

Whitelist (бот)

agents.analyst.allowed_mcp_tools — только эти MCP tools попадают в AI loop.

По умолчанию включены searxng_web_search и web_url_read; они активны только при searxng.enabled: true.

Native tool submit_metadata_brief — всегда доступен для финализации.

Отладка

Логи бота: AnalystAgent MCP [server]: tools=[...], Analyst MCP: brief ready.

HTTP fallback: conf_doc_fallback в env.json при недоступности MCP conf-doc.

SearXNG 403 и smoke-test: docs/searxng.md.