Skip to main content

​
概述

Reportify MCP 是一个基于 MCP (Model Context Protocol) 协议的金融数据服务，提供文档搜索、公司财务数据、股票行情等丰富的金融信息查询工具。通过 MCP 协议，您可以：
  • 搜索和获取金融文档内容
  • 查询公司财务数据和基本信息
  • 获取实时股票行情和历史数据
  • 与智能体进行对话交互

​
架构设计

服务采用 Gateway + 多 MCP 服务器 架构，按功能分类提供 4 个独立的 MCP 端点： 
MCP Gateway (https://mcp.reportify.cn)
├── /search/mcp    - 文档搜索类工具
├── /stock/mcp     - 股票数据类工具
├── /agent/mcp     - Agent 对话类工具
└── /channels/mcp  - 频道与时间线类工具
每个端点都是独立的 MCP 服务器，客户端可以按需选择连接。

Search MCP

文档搜索类工具
  • 综合文档搜索（财报、研报、公告等）
  • 语义搜索和内容块检索
  • 文档列表和详情获取
  • 知识库搜索

Stock MCP

股票数据类工具
  • 公司基本信息和财务报表
  • 实时行情和历史股价
  • 指数和行业数据
  • 量化分析工具

Agent MCP

Agent 对话类工具
  • 创建和管理对话会话
  • 发送消息并接收响应
  • 获取对话历史和生成文件

Channels MCP

频道与时间线类工具
  • 频道搜索和订阅管理
  • 公司/话题/机构时间线
  • 媒体内容时间线

​
接入配置

​
MCP 服务端点

服务端点 URL说明
Search MCPhttps://mcp.reportify.cn/search/mcp文档搜索类工具
Stock MCPhttps://mcp.reportify.cn/stock/mcp股票数据类工具
Agent MCPhttps://mcp.reportify.cn/agent/mcpAgent 对话类工具
Channels MCPhttps://mcp.reportify.cn/channels/mcp频道时间线类工具

​
客户端配置

在 Cursor 的 MCP 配置文件中添加以下配置（可按需选择部分或全部服务）：
{
  "mcpServers": {
    "reportify-search": {
      "url": "https://mcp.reportify.cn/search/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "reportify-stock": {
      "url": "https://mcp.reportify.cn/stock/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "reportify-agent": {
      "url": "https://mcp.reportify.cn/agent/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "reportify-channels": {
      "url": "https://mcp.reportify.cn/channels/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
必须在配置中包含 Authorization 字段，否则请求将无法通过认证

​
认证

所有 MCP 请求都需要在 HTTP 请求头中包含 Bearer Token： 
Authorization: Bearer YOUR_API_KEY
获取 API Key
  • 将 YOUR_API_KEY 替换为您的实际 API Key
  • 注意 Bearer 后面有一个空格
  • API Key 可以在 Reportify 控制台 获取

​
Tools 参考

​
Search MCP (/search/mcp)

文档与搜索相关工具。
股票代码使用 market:ticker 格式，如 US:AAPL、HK:00700、SH:600519

搜索工具

工具名功能描述
comprehensive_search综合搜索金融投资文档
earnings_searchSearch for earnings-related documents submitted to exchanges (query optional, sorted by date desc or relevance)
conferences_searchSearch for earnings-related conference call transcripts and presentation slides (query optional, sorted by date desc or relevance)
minutes_search搜索电话会议和 IR 会议
reports_search搜索机构研究报告
filings_search搜索公司公告
news_search搜索金融新闻
socials_search搜索社交媒体内容
webpage_search搜索网页内容
kb_search搜索知识库
公共参数：
参数类型必填说明
querystring是搜索关键词
numinteger否返回结果数量，默认 10
symbolsstring[]否股票代码列表（格式：market:ticker）
start_datetimestring否开始时间
end_datetimestring否结束时间
工具名功能描述
docs_list文档列表查询
docs_by_symbols按股票代码查询文档
docs_by_tags按标签查询文档
document_fetch获取文档详情
document_raw_content获取文档原始内容
document_summary获取文档摘要
docs_upload上传文档
docs_delete删除文档
folder_create创建文件夹
folder_delete删除文件夹

​
Stock MCP (/stock/mcp)

股票数据、概念板块和量化分析工具。
股票代码直接使用 ticker，不带市场前缀，如 AAPL、00700、600519

公司数据

工具名功能描述
company_overview获取公司基本面信息
company_shareholders获取股东信息
income_statement获取利润表
balance_sheet获取资产负债表
cashflow_statement获取现金流量表
revenue_breakdown获取营收构成
公共参数：
参数类型必填说明
symbolstring是股票代码（不带市场前缀）
periodstring否报告周期（annual/quarterly）
limitinteger否返回记录数量
工具名功能描述
stock_quote获取股票行情
index_quote获取指数行情
earnings_calendar财报日历
ipo_calendar_hk港股 IPO 日历
工具名功能描述
index_constituents获取指数成分股
index_tracking_funds获取指数跟踪基金（ETF）
industry_constituents获取行业成分股
concepts_today今日概念板块
concepts_latest最新概念动态
followed_companies用户关注的公司
工具名功能描述
indicators获取可用技术指标列表
indicators_compute计算技术指标（RSI, MACD, KDJ, BOLL, ATR 等）
factors获取可用因子列表（技术因子 + 基本面因子）
factors_compute计算因子值（支持技术和基本面因子）
factors_screen因子筛选选股
ohlcv获取单只股票 OHLCV 数据
ohlcv_batch批量获取多只股票 OHLCV 数据
backtest策略回测
支持的因子类型：
  • 技术因子：RSI(14), MACD(), BOLL(20,2), KDJ(), ATR(14) 等
  • 基本面因子：PE(), PE_TTM(), PB(), ROE(), ROA(), EPS() 等
  • 财务报表：INCOME.net_profit, BALANCESHEET.total_assets 等
  • 组合筛选：(PE() < 20) & (RSI(14) < 40)

​
Agent MCP (/agent/mcp)

Agent 对话相关工具。

对话工具

工具名功能描述
create_conversation创建新对话
agent_chat与 Agent 对话
get_conversation获取对话详情
list_messages列出对话消息
get_message_events获取消息事件
cancel_execution取消 Agent 执行
get_agent_file获取 Agent 生成的文件
使用流程：
  1. 调用 create_conversation 创建对话，获取 conversation_id
  2. 调用 agent_chat 发送消息，传入 conversation_id 和 message
  3. 调用 get_message_events 获取响应内容
  4. 如需要，调用 get_agent_file 获取生成的文件

​
Channels MCP (/channels/mcp)

频道订阅与时间线工具。

频道工具

工具名功能描述
channels_search搜索频道
following_channels获取已关注频道
channel_follow关注频道
channel_unfollow取消关注
channel_docs获取频道文档
工具名功能描述
timeline_companies公司时间线
timeline_topics话题时间线
timeline_institutes机构时间线
timeline_public_media公共媒体时间线
timeline_social_media社交媒体时间线

​
快速开始

使用 Search MCP 搜索苹果公司最近的财报相关文档：
{
  "tool": "earnings_search",
  "parameters": {
    "query": "revenue growth",
    "symbols": ["US:AAPL"],
    "num": 5
  }
}

​
股票代码格式

注意：Search MCP 和 Stock MCP 使用不同的股票代码格式

​
Search MCP（搜索和文档）

使用 market:ticker 格式：
市场格式示例
美股US:代码US:AAPL, US:GOOGL, US:TSLA
港股HK:代码HK:00700, HK:09988
沪市SH:代码SH:600519, SH:601398
深市SZ:代码SZ:000001, SZ:000858

​
Stock MCP（股票数据）

直接使用股票代码，不带市场前缀：
市场格式示例
美股直接使用代码AAPL, GOOGL, TSLA
港股直接使用代码00700, 09988
A股直接使用代码600519, 000001

​
错误处理

MCP 调用使用标准的 HTTP 状态码：
  • 200 - 请求成功
  • 400 - 请求参数错误
  • 401 - 认证失败（API Key 无效或未提供）
  • 404 - 请求的资源不存在
  • 429 - 请求频率超限
  • 500 - 服务器内部错误
错误响应示例： 
{
  "error": "Invalid symbol format"
}

​
最佳实践

保护 API Key请妥善保管您的 API Key，避免在公开场所泄露：
  • 不要将 API Key 提交到代码仓库
  • 使用环境变量或配置文件管理
  • 定期轮换 API Key
按需选择 MCP 服务根据实际需求选择连接的 MCP 服务：
  • 只需搜索功能：连接 Search MCP
  • 只需股票数据：连接 Stock MCP
  • 需要完整功能：连接全部 4 个服务
合理使用参数优化查询性能和结果质量：
  • 使用时间范围缩小搜索范围
  • 通过股票代码精确筛选
  • 合理设置返回结果数量
时间格式规范时间参数使用统一格式：
  • 日期时间：YYYY-MM-DD HH:mm:ss（如 2025-01-01 00:00:00）
  • 仅日期：YYYY-MM-DD（如 2025-01-01）