Files
market_sync/app
gao 91e83a3b0b feat(mcp): MCP server (5 tools) — 任务/状态/数据集/详情/今日汇总
新增 app/mcp_server.py,让 LLM (Claude Desktop / Claude Code) 通过
MCP stdio 协议查询 market_sync 的同步情况:

工具列表:
  1. list_sync_tasks        - 列出 13 个 sync task + 当前状态 + 7d 运行统计
  2. get_task_status        - 单个 task 的状态机 + 最近 N 天所有 run
  3. list_datasets          - 17 张 PG 表的行数 + 日期范围
  4. get_dataset_info       - 单表的 schema/索引/PK + 3 行抽样(白名单防注入)
  5. get_today_sync_summary - 今日 KPI + 每个 task 的最新 run

传输: stdio (本地启动 Claude Desktop 直连)
启动: python -m app.mcp_server
依赖: mcp[cli]>=1.0.0 (已加入 requirements.txt)

复用层: app.core.db.ops + app.core.sync.registry 的 helper,
不绕过 ORM session (与 dashboard API 一致)。

验证:
  - initialize 握手 OK
  - tools/list 返回 5 个工具的完整 schema
  - 各 tool 在 stdio 协议下正常返回 JSON
2026-07-07 17:59:05 +08:00
..