Skip to main content
Glama
diyan-research-mcp

diyan-research-mcp

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

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

这个仓库里没有数据

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

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

这样分层有三个后果,都是有意为之:

  • 壳可以公开审阅,因为它不含任何专有数据,也不含任何密钥。

  • 租户身份、档位和配额一律由服务端裁定,壳不做信任判断,也就无法被绕过。

  • 输出过滤留在壳内而不是只放在服务端,即便服务端出错或被篡改,交易类表述也无法离开进程。

Related MCP server: Continental-MCP-Server

工具

工具

说明

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,只在自建部署或联调时需要。

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

本地运行

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

测试不需要网络和凭据:

python -m unittest discover -s tests -v

边界

  • 只读。没有任何写入、下单、部署或数据导出能力。

  • 不返回实时行情。快照与摘要都是冻结产物,每条结果都带 as_of。

  • 不生成买卖、仓位、股数、跟单或收益承诺。含此类表述的提问在发出请求前就会被拒绝。

  • 不读取使用者的本地文件、本地数据库或非必要环境变量。

服务端契约

如需自建后端,接口定义见 docs/BACKEND_CONTRACT.md。

许可与归属

由深圳瞳桦文化传媒有限公司开发与维护。MIT 许可,见 LICENSE。

Available Tools

6 tools
cognition_radar_readA

读取历史主题研究雷达摘要,并标注其非实时性。

Inputs: no named parameters.

framework_excerptB

读取经过批准的研究框架片段。framework 为 enterprise/business/finance/people/brand。

Inputs: framework (required), query, max_chars.

hypothesis_getA

读取通过交付证据门槛的冻结假设;不返回未验证假设。

Inputs: hypothesis_id (required).

ic_backtest_summaryA

读取冻结的因子历史 IC 摘要;不提供原始行情或面板。

Inputs: no named parameters.

research_analyze_safeD

调用受控研究接口,删除交易字段并附加研究辅助边界。

Inputs: symbol (required), question (required), market.

stock_snapshot_latestA

读取最新冻结的股票研究快照,不代表实时市场状态。

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct research artifact—framework, stock snapshot, hypothesis, radar, IC backtest, and safe analysis—with no overlap in purpose. The descriptions clearly delineate what each returns, eliminating ambiguity.

    Naming Consistency2/5

    Tool names mix noun compounds (framework_excerpt, ic_backtest_summary) with verb-suffix patterns (hypothesis_get, cognition_radar_read) and a verb-adjective combo (research_analyze_safe), lacking a unified convention. This inconsistency makes the naming pattern hard to predict.

    Tool Count5/5

    Six tools is well within the ideal 3-15 range and appropriately scoped for a read-only research server providing diverse artifact views. Each tool earns its place without bloat.

    Completeness3/5

    The surface covers multiple research components, but lacks discovery tools to list available frameworks, stocks, or hypotheses. This could require agents to have prior knowledge of entity identifiers, creating a notable gap in usability.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for short-term stock and ETF market research, providing tools for futures, premarket movers, market breadth, earnings, watchlist signals, and daily briefings.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A research-only MCP server providing read-only data, analytics, and intelligence for Polymarket BTC 5-minute Up/Down markets, enabling LLM agents to query market snapshots, performance metrics, and strategy candidates.
      -
    • A
      license
      A
      quality
      B
      maintenance
      A read-only MCP server for EdgeDepth's market microstructure search engine, enabling users to query recorded crypto and TradFi perpetuals for market conditions, outcomes, and reproducibility-keyed evidence directly from MCP clients.
      10
      167 npm
      3
      MIT