MCP Server

MCP-Server — pfs-strategist (18 инструментов)

🇬🇧 English: MCP-Server-EN

Источник: tools/pfs/mcp_server.py, .mcp.json. Сервер: stdio, JSON-RPC 2.0, построчно, без внешних зависимостей — тот же stdlib-код, что и CLI.

Подключение

.mcp.json в корне репозитория подхватывается Claude Code / Cursor автоматически:

{
  "mcpServers": {
    "pfs-strategist": { "command": "python3", "args": ["-m", "tools.pfs.mcp_server"] },
    "linear":  { "…": "npx -y mcp-server-linear, ключ LINEAR_API_KEY из .env" },
    "lovable": { "type": "http", "url": "https://mcp.lovable.dev", "…": "OAuth: /mcp → Authenticate" },
    "rea":     { "command": "npx", "args": ["-y", "rea-agents@6.7.0", "mcp"] }
  }
}

Запуск вручную: python3 -m tools.pfs.mcp_server.

18 инструментов

#	Инструмент	Назначение
1	pfs_status	состояние активного проекта: шаги, следующее действие, вопросы, стоимость
2	pfs_route	сценарий запроса, методические карты и модели по шагам (override — принудительный сценарий)
3	pfs_kb_search	BM25-поиск по базе знаний (опция with_project — с учётом доменов проекта)
4	pfs_source_add	зарегистрировать источник: URL или файл (pdf/docx/xlsx/csv/html/md); origin: public/own/interview/synthetic
5	pfs_claim_add	записать утверждение (fact/hypothesis/forecast/assumption/inference; факт требует источник)
6	pfs_claims	таблица активных утверждений, фильтр по kind
7	pfs_check	контроль качества документов и реестра
8	pfs_impact	какие выводы, документы и решения затронет изменение C###/S###
9	pfs_decisions_due	что решать сейчас: просрочки, пересмотры, устаревшие основания
10	pfs_models_pick	какую модель использовать для задачи
11	pfs_next	сводка «что решать сейчас»: шаг, ожидания человека, обязательства, пересмотры, вопросы
12	pfs_source_refresh	перезагрузить web-источник S###: дельта sha256, бэкап старого текста, flags внедрённых фраз
13	pfs_data_funnel	воронка по таблице (csv/xlsx): уникальные пользователи на каждом шаге
14	pfs_data_stats	описательная статистика столбца (n, среднее, медиана, stdev, перцентили, ci95; group — по группам)
15	pfs_interview_guide	каркас гайда интервью → interviews/synthetic/guide_<персона>.md
16	pfs_interview_save	зарегистрировать транскрипт ИИ-респондента (origin=synthetic, только гипотезы)
17	pfs_media_add	медиа-файл: копия в sources/raw/, описание «только видимое» = текстовый источник kind=media
18	pfs_ux_scaffold	каркас UX-анализа по чек-листу эвристик → analysis/ux_<S###>.md

Как устроено внутри

• Инструменты 1–10 — обёртки над CLI-командами (перехват stdout/stderr в результат MCP).
• Инструменты 11–18 (DIRECT) вызывают модули project, sources, data, participate напрямую — у части из них нет отдельной CLI-команды.
• Каждый вызов возвращает и текст, и structuredContent; ошибки — isError: true с текстом, сервер не падает на одном запросе (исключение → JSON-RPC error).
• Проект — активный, тот же, что у CLI (pfs use).

Зачем MCP, если есть CLI

Один и тот же код доступен в двух протоколах: агент в среде с MCP вызывает инструменты нативно (Cursor, Claude Code), в остальных — через shell. Гарантии не различаются: факт без источника не запишется ни так, ни так. Другие серверы в .mcp.json (Linear, Lovable, Rea) — интеграции среды, не часть pfs.

См. также: CLI-Reference · Hooks · Routing-and-Models