Metadata-Version: 2.4
Name: diyan-research-mcp
Version: 0.1.1
Summary: 面向企业投研与产业研究团队的只读研究 MCP，每条结论附来源、数据截至日与证伪条件。
Project-URL: Homepage, https://github.com/mikeli20221102-ux/diyan-research-mcp
Project-URL: Source, https://github.com/mikeli20221102-ux/diyan-research-mcp
Author: 深圳瞳桦文化传媒有限公司
License: MIT License
        
        Copyright (c) 2026 深圳瞳桦文化传媒有限公司 (Shenzhen Tonghua Culture Media Co., Ltd.)
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: enterprise,evidence,mcp,provenance,research
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.27
Requires-Dist: mcp<2,>=1.12
Description-Content-Type: text/markdown

# diyan-research-mcp · 企业研究证据链

<!-- mcp-name: io.github.mikeli20221102-ux/diyan-research-mcp -->

面向企业投研与产业研究团队的只读研究 MCP，提供研究框架、冻结快照与历史因子摘要，每条结论附来源、数据截至日与证伪条件，不输出交易建议。

## 这个仓库里没有数据

本仓库只包含转发壳，职责是三件事：校验入参、携带租户凭据调用研究数据服务、在返回前剥掉交易类字段。研究框架、冻结快照、假设台账和因子摘要都存放在服务端，不随代码分发。

```
AI 客户端  ──MCP──▶  diyan-research-mcp（本仓库）  ──HTTPS──▶  研究数据服务
                     入参校验 / 凭据转发 / 输出过滤        数据、租户、档位、配额、审计
```

这样分层有三个后果，都是有意为之：

- 壳可以公开审阅，因为它不含任何专有数据，也不含任何密钥。
- 租户身份、档位和配额一律由服务端裁定，壳不做信任判断，也就无法被绕过。
- 输出过滤留在壳内而不是只放在服务端，即便服务端出错或被篡改，交易类表述也无法离开进程。

## 工具

| 工具 | 说明 |
|---|---|
| `framework_excerpt` | 读取研究框架片段，可选 enterprise / business / finance / people / brand |
| `stock_snapshot_latest` | 读取最新冻结的股票研究快照 |
| `hypothesis_get` | 读取通过交付证据门槛的冻结假设 |
| `cognition_radar_read` | 读取历史主题研究雷达摘要 |
| `ic_backtest_summary` | 读取冻结的因子历史 IC 摘要 |
| `research_analyze_safe` | 调用受控研究接口做单标的研判 |

工具是否可用取决于凭据对应的档位。免费档开放研究框架与部分冻结快照，其余返回 `error_type: backend` 并说明需要付费租户凭据。

## 配置

唯一必填项是 `DIYAN_API_KEY`，在 MCP 详情页填写即可。其余变量见 `.env.example`，只在自建部署或联调时需要。

凭据缺失时进程仍会正常启动，但每次工具调用都会返回明确的配置错误。这是刻意的：托管环境可能在使用者填写凭据之前就拉起进程，启动即崩溃会让详情页上的服务看起来是坏的。

## 本地运行

```bash
python -m pip install -r requirements.txt
export PYTHONPATH=src
export DIYAN_API_KEY=<你的租户凭据>
export DIYAN_TRANSPORT=stdio
python -m diyan_research_mcp.server
```

测试不需要网络和凭据：

```bash
python -m unittest discover -s tests -v
```

## 边界

- 只读。没有任何写入、下单、部署或数据导出能力。
- 不返回实时行情。快照与摘要都是冻结产物，每条结果都带 `as_of`。
- 不生成买卖、仓位、股数、跟单或收益承诺。含此类表述的提问在发出请求前就会被拒绝。
- 不读取使用者的本地文件、本地数据库或非必要环境变量。

## 服务端契约

如需自建后端，接口定义见 [`docs/BACKEND_CONTRACT.md`](docs/BACKEND_CONTRACT.md)。

## 许可与归属

由深圳瞳桦文化传媒有限公司开发与维护。MIT 许可，见 [`LICENSE`](LICENSE)。
