linker-report-mcp

MCP server，用于检索机构研报（华泰期货、天风证券等）。通过 RAGFlow 向量数据库进行语义检索，支持按品种、日期、板块、来源等维度过滤。

工具

search_research_report

语义检索机构研报片段。返回与问题最相关的研报文本，每条结果含：

• content — 研报正文片段
• source — 报告全名（可溯源到具体机构、品种、日期）
• score — 相关度分数

参数：

| 参数 | 必填 | 说明 | |------|------|------| | question | 是 | 检索问题，用于语义匹配 | | commodity | 否 | 品种过滤：液化石油气、甲醇、原油、聚丙烯、乙二醇、铝、铜等 | | date | 否 | 精确日期 YYYY-MM-DD | | start_date | 否 | 起始日期（与 end_date 配合） | | end_date | 否 | 结束日期（与 start_date 配合） | | sector | 否 | 板块：能源化工、黑色金属、有色金属、农产品、贵金属 | | source | 否 | 来源机构：华泰期货、天风证券 | | top_k | 否 | 返回片段数，默认 8 |

建议：尽量传 commodity 参数，可显著提高召回精度（score 从 0.5+ 提升到 0.8+）。

配置

{
  "mcpServers": {
    "linker-report": {
      "command": "npx",
      "args": ["-y", "linker-report-mcp@latest"],
      "env": {
        "RAGFLOW_API_BASE": "http://192.168.20.118:30080",
        "RAGFLOW_API_KEY": "ragflow-TlV2VxzljJgN11H8are6cDdugnsWk3PXWkWqrrv-_wk",
        "REPORT_KB_ID": "bbcca515025111f1bd0d961ef7d70cd5"
      }
    }
  }
}

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | RAGFLOW_API_BASE | 是 | RAGFlow 服务地址 | | RAGFLOW_API_KEY | 是 | RAGFlow API Key | | REPORT_KB_ID | 是 | 机构研报知识库 ID |

知识库元数据

研报文档的 meta_fields：

| 字段 | 示例 | 说明 | |------|------|------| | commodity | 液化石油气 | 品种 | | date | 2026-03-13 | 研报发布日期 | | frequency | 日度 | 日度/周度/月度/季度 | | sector | 能源化工 | 板块 | | source | 华泰期货 | 来源机构 |

元数据由 ragflow_meta_cleaner.py 定时清洗维护（每2小时），从文件名自动提取。

本地开发

cd packages/linker-report-mcp
npm install
npm run build

# 测试
RAGFLOW_API_BASE=http://192.168.20.118:30080 \
RAGFLOW_API_KEY=ragflow-TlV2VxzljJgN11H8are6cDdugnsWk3PXWkWqrrv-_wk \
REPORT_KB_ID=bbcca515025111f1bd0d961ef7d70cd5 \
node dist/index.js

发布

npm version patch
npm run build
npm publish --access public