研报：行业研报检索

该 MCP 服务以行业研报检索为核心，提供行业研报、公司研究、宏观策略和主题报告的检索与详情查询能力。

所属板块：综合信息

主要功能

• 行业研报关键词检索
• 机构和行业筛选
• 报告类型与发布时间筛选
• 研报详情和来源链接

服务设计说明

• 服务通过检索和详情两个 Tool 完成“发现研报—筛选研报—读取详情”的完整查询链路。
• 服务提供 2 个只读 Tool，单次 Tool 调用只访问一个 Product ID。
• 翻页结果统一收口为 total 与 resultList。
• 成功响应自动兼容 Gateway业务 data和内部 stat/data 两种形态。
• 请求超时可通过 HANDAAS_REQUEST_TIMEOUT 配置，默认30秒。

环境要求

• Python 3.10+
• 依赖：mcp、python-dotenv、requests

本地快速启动

cd research-report-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

服务默认地址：http://127.0.0.1:8000/mcp。支持 stdio、sse 和 streamable-http。

环境变量

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

真实凭据只能保存在本地 .env 或部署密钥中。

Cursor / Cherry Studio配置

{
  "mcpServers": {
    "research-report-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

可用 Tool 与 Product ID

MCP Tool	使用场景	Product ID	关键输入
research_report_search	按关键词、机构、行业、类型和日期检索研报	6a7c6501c90c69ced247c5b2	研报筛选条件、分页
research_report_detail	查询研报元数据和来源链接	6a7c69c18af44788d4b20653	reportId

推荐调用流程

1. 调用 research_report_search 搜索研报并缩小候选范围。
2. 根据标题、机构、行业、类型和发布日期确认目标研报。
3. 使用结果中的 reportId 调用 research_report_detail 获取完整元数据和来源链接。

Tool 详细说明

1. research_report_search

何时使用：用户需要查找某个行业、公司、主题、机构或时间范围内的研报时使用。

关键参数：rpKeyword 搜索研报标题；rpOrgName 搜索机构全称或简称；rpCalIndustryList 和 rpType 用于精确筛选；日期格式为 YYYY-MM-DD；pageSize 最大 50。

返回说明：返回研报标题、机构、发布日期、行业、类型和 reportId，不返回研报正文文件。

2. research_report_detail

何时使用：已经确认目标研报，需要获取机构、行业、类型、发布日期和来源链接时使用。

关键参数：reportId 必须来自 research_report_search 的结果。

返回说明：返回研报元数据以及来源链接字段；Tool 不购买、不下载、不打开或解析 PDF 文件。

使用示例

示例一：检索行业研报

搜索 2026 年发布的人工智能行业研报，先返回 10 条。

{
  "tool": "research_report_search",
  "arguments": {
    "rpKeyword": "人工智能",
    "rpCalIndustryList": "人工智能",
    "rpPublishDateStart": "2026-01-01",
    "rpPublishDateEnd": "2026-12-31",
    "pageIndex": 1,
    "pageSize": 10
  }
}

示例二：查询研报详情

查看刚才选中研报的发布机构、行业分类、发布日期和来源链接。

{
  "tool": "research_report_detail",
  "arguments": {
    "reportId": "从研报检索结果取得"
  }
}

使用注意事项

1. 详情必须使用检索结果中的 reportId。
2. 起始日期不能晚于截止日期。
3. Tool 只返回来源链接元数据，不打开、购买、下载或解析研报文件。
4. 研报观点属于原发布机构，不代表 MCP 服务立场。

测试验证

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

单元测试使用 Mock 响应；真实验证通过本地 .env 调用 HandaaS Integrator Gateway。