{
  "markdown": "# diyan-research-mcp · 企业研究证据链\n\n<!-- mcp-name: io.github.mikeli20221102-ux/diyan-research-mcp -->\n\n面向企业投研与产业研究团队的只读研究 MCP，提供研究框架、冻结快照与历史因子摘要，每条结论附来源、数据截至日与证伪条件，不输出交易建议。\n\n## 这个仓库里没有数据\n\n本仓库只包含转发壳，职责是三件事：校验入参、携带租户凭据调用研究数据服务、在返回前剥掉交易类字段。研究框架、冻结快照、假设台账和因子摘要都存放在服务端，不随代码分发。\n\n```\nAI 客户端  ──MCP──▶  diyan-research-mcp（本仓库）  ──HTTPS──▶  研究数据服务\n                     入参校验 / 凭据转发 / 输出过滤        数据、租户、档位、配额、审计\n```\n\n这样分层有三个后果，都是有意为之：\n\n- 壳可以公开审阅，因为它不含任何专有数据，也不含任何密钥。\n- 租户身份、档位和配额一律由服务端裁定，壳不做信任判断，也就无法被绕过。\n- 输出过滤留在壳内而不是只放在服务端，即便服务端出错或被篡改，交易类表述也无法离开进程。\n\n## 工具\n\n| 工具 | 说明 |\n|---|---|\n| `framework_excerpt` | 读取研究框架片段，可选 enterprise / business / finance / people / brand |\n| `stock_snapshot_latest` | 读取最新冻结的股票研究快照 |\n| `hypothesis_get` | 读取通过交付证据门槛的冻结假设 |\n| `cognition_radar_read` | 读取历史主题研究雷达摘要 |\n| `ic_backtest_summary` | 读取冻结的因子历史 IC 摘要 |\n| `research_analyze_safe` | 调用受控研究接口做单标的研判 |\n\n工具是否可用取决于凭据对应的档位。免费档开放研究框架与部分冻结快照，其余返回 `error_type: backend` 并说明需要付费租户凭据。\n\n## 配置\n\n唯一必填项是 `DIYAN_API_KEY`，在 MCP 详情页填写即可。其余变量见 `.env.example`，只在自建部署或联调时需要。\n\n凭据缺失时进程仍会正常启动，但每次工具调用都会返回明确的配置错误。这是刻意的：托管环境可能在使用者填写凭据之前就拉起进程，启动即崩溃会让详情页上的服务看起来是坏的。\n\n## 本地运行\n\n```bash\npython -m pip install -r requirements.txt\nexport PYTHONPATH=src\nexport DIYAN_API_KEY=<你的租户凭据>\nexport DIYAN_TRANSPORT=stdio\npython -m diyan_research_mcp.server\n```\n\n测试不需要网络和凭据：\n\n```bash\npython -m unittest discover -s tests -v\n```\n\n## 边界\n\n- 只读。没有任何写入、下单、部署或数据导出能力。\n- 不返回实时行情。快照与摘要都是冻结产物，每条结果都带 `as_of`。\n- 不生成买卖、仓位、股数、跟单或收益承诺。含此类表述的提问在发出请求前就会被拒绝。\n- 不读取使用者的本地文件、本地数据库或非必要环境变量。\n\n## 服务端契约\n\n如需自建后端，接口定义见 [`docs/BACKEND_CONTRACT.md`](docs/BACKEND_CONTRACT.md)。\n\n## 许可与归属\n\n由深圳瞳桦文化传媒有限公司开发与维护。MIT 许可，见 [`LICENSE`](LICENSE)。\n",
  "bytes": 1638,
  "sha": "69fbb22664536b7a75ef3a3c2f936c1b38fe878135564fba57bf53795a0c7b5a",
  "repo_slug": "mikeli20221102-ux/diyan-research-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mikeli20221102_ux_diyan_resear_27f7c706/readme"
}