Comein Investment Research

进门投研连接器使用指南

连接器名称：comein-mcp-all（进门投研平台） MCP Server：mcp-server-brm SSE 地址：https://mcp-server-global.comein.cn/mcp-servers/mcp-server-brm/sse 工具前缀：mcp__comein-mcp-all__（实际前缀以 tools/list 返回为准） 时间格式统一：yyyy-MM-dd HH:mm:ss

⚠️ MCP 工具可能随时变化（新增、改名、参数调整、废弃）。本文档的工具清单和参数仅为编写时快照，不保证与实时 MCP 一致。执行任何任务前，必须先读取当前 MCP tools/list，以实时返回的 name、description、inputSchema 作为唯一工具契约。 文档中工具名和参数表仅用于路由参考和意图理解，不作为调用依据。

1. 动态工具原则

1.1 实时优先

• 每次执行前必须读取当前 MCP tools/list，以工具实时 description、inputSchema 和返回结果作为唯一工具契约。
• 本文档第 7 节的工具清单和参数表是编写时快照，仅帮助理解能力范围和路由意图，不作为实际调用的参数依据。
• 如果 tools/list 返回的工具名、参数或返回字段与本文档不一致，以 tools/list 为准。
• 如果 MCP 新增了本文档未覆盖的工具，根据 description 判断是否匹配任务，直接使用。
• 如果本文档记录的工具在 tools/list 中已消失或改名，根据 description 重新匹配同类能力；无法匹配时告知用户当前可用工具范围。

1.2 调用原则

• 根据任务所需能力选择最匹配的专用工具或工具组合，不依赖固定工具名、工具数量、参数或返回字段。
• 使用综合检索能力获取全貌或补充召回；涉及行情、财务、基金、宏观等结构化事实时，优先选择对应专用能力。
• 直接使用 MCP 返回的标准工具名，不添加客户端私有前缀，不传入实时 Schema 未声明的参数。
• 文档中的枚举值（如 recordStatus、reportType 等）如有变化，以 tools/list 的 inputSchema 中的 enum 或 description 为准。

2. 认证与权限

• 首次连接时，由 WorkBuddy 打开浏览器完成进门 OAuth 授权，仅使用当前账号已有权限。
• Access Token 过期时由 WorkBuddy 自动刷新；收到 401 或授权失效时，引导用户重新连接。
• 收到 403 或业务权限不足时，说明受限范围，并提示联系所属机构管理员或进门服务人员开通后重试。
• 不读取、记录或输出 Token、Cookie、用户身份、机构权限、会议密码或主持人密钥。

3. 能力路由与调用原则

4. 推荐工作流

1. 确认用户目标、主体、市场、时间范围及必要口径；只有缺少的信息会实质改变结果时才追问一个关键条件。
2. 读取当前工具清单和 Schema，选择任务匹配度最高的能力。
3. 先获取事实或原始观点，再根据任务需要进行跨来源、跨口径验证。
4. 需要解释数据变化时，将结构化数据与机构观点结合，但分开呈现证据和推断。
5. 输出时注明主体、绝对日期、数据或来源类型、关键口径及未验证项。

典型场景

5. 写操作与异步任务

• 查询类操作可直接执行；创建、上传、订阅、添加、重命名、提交和删除等写操作必须来自用户明确请求。
• 批量写入前展示对象和数量；删除前回读目标名称、唯一 ID 和归属范围并再次确认。
• 写入后使用当前可用的查询或访问能力回读；未获得成功响应时不得宣称完成。
• 异步任务只提交一次，保留任务 ID，并通过当前匹配的状态或结果能力查询；超时只报告当前状态，不重复创建任务。
• 部分成功时分别列出成功、跳过和失败项，不把整批操作标记为完成。

6. 错误、降级与内容边界

• 区分未连接、未授权、权限不足、参数错误、空结果和工具限制，分别给出可执行的下一步。
• 实体命中多个候选时先消歧；结果为空时检查主体、市场、代码、时间、报告期和披露滞后，再决定是否调整范围。
• 专用能力不可用时，可使用当前综合能力降级检索，但不得伪造缺失字段、数据口径或成功状态。
• 不将"无结果"直接解释为"不存在"，不将单次工具缺失表述为平台永久不支持。
• 不在上架文案或输出中宣称提供"非公开信息"；仅描述用户当前权限范围内可访问的投研内容。

7. 工具清单与参数详解

⚠️ 以下为编写时快照，仅供路由参考和意图理解。MCP 工具可能已变化（新增/改名/参数调整/废弃）。实际调用前务必读取 tools/list，以实时 Schema 为准。

当发现以下情况时，以 tools/list 为准：

• 工具名不一致 → 按 description 重新匹配
• 参数名/类型/必填变化 → 按 inputSchema 调用
• 枚举值变化 → 按 inputSchema 中的 enum 调用
• 工具被废弃 → 用 description 匹配替代能力
• 出现新工具 → 按 description 判断是否适用当前任务

7.1 会议管理（8 个工具）

meeting_recording_submit — 提交代录信息

{"meetingInfo": "腾讯会议 123-456-789，主题：2026Q2新能源行业展望，时间：2026-08-05 14:00:00"}

meeting_recording_list — 查询代录列表

meeting_recording_delete — 删除代录信息

self_meeting_create — 创建预约会议

self_meeting_list — 查询自助会议列表

meeting_activity_list — 查询进门路演列表

⚠️ 时间限制：开始时间不能早于三天前，结束时间不能晚于三天后。

research_activity_list — 查询调研活动列表

strategy_list — 查询策略列表

7.2 数据分析（15 个工具）

company_finance_search — 查询财务报表数据

{
  "querys": ["贵州茅台", "五粮液"],
  "reportDates": [{"fiscalYear": 2024, "reportType": "A", "type": "year"}],
  "searchData": ["营业总收入", "净利润", "归母净利润", "毛利率", "净资产收益率(ROE)"]
}

get_main_business_segments — 查询主营分拆数据

⚠️ 主营拆分数据一般在年报和半年报披露。

getStockProfitForecast — 查询盈利预测

indicatorNameRetrieve — 检索宏观指标

indicatorInfoRetrieve — 查询指标采集信息

indicatorDataRetrieve — 查询指标数值时序

futures_contracts — 查询期货合约信息

futures_kline — 查询期货 K 线

futures_price — 查询期货实时报价

⚠️ symbol 传具体月份合约代码（非主力品种代码），多个逗号分隔。

searchIndexQuotation — 指数数据统一查询

四种模式：

screenerStock — 多条件组合选股

⚠️ 务必一次性传入全部筛选条件，禁止分步迭代查询。 用户无明确市场要求时，默认 marketType 为 sh/sz/bj（即 A 股）。

数值筛选可用字段：changePct(涨跌幅) marketCap(总市值) turnoverRate(换手率) latestPrice(最新价) turnoverVolume(成交量) turnoverValue(成交额) lyrPe(静态PE) ttmPe(滚动PE) pb(市净率) ttmDividendRatio(滚动股息率) changePctWeek/Month/ThreeMonth/SixMonth/Ytd(多周期涨跌幅)

枚举筛选可用字段：concept(股票概念，如"高股息"、"半导体") marketType(sh/sz/bj/hk/us)

{
  "page": 1, "size": 20,
  "sort": [{"field": "marketCap", "order": "desc"}],
  "numberConditions": [
    {"key": "ttmPe", "range": {"gte": 0, "lte": 30}},
    {"key": "ttmDividendRatio", "range": {"gte": 3}}
  ],
  "enumConditions": [
    {"key": "marketType", "values": ["sh", "sz"]},
    {"key": "concept", "values": ["高股息"]}
  ]
}

get_fund_holdings — 查询基金持仓与暴露

get_stock_details — 批量查询公司基本信息

pricePerformance — 批量查询股票行情与表现

company_report_date_search — 查询最新报告期

⚠️ 仅支持 A 股，不支持港股、美股。

7.3 自选股管理（5 个工具）

watchlist_stock_list — 查询自选股列表

stock_group_list — 查询自选分组列表

无参数。

create_portfolio_group — 创建自选股分组

⚠️ 分组名称不能为空，且需在该用户下唯一。

add_stocks_to_portfolio_group — 向分组添加股票

💡 如果用户尚未创建该分组，请先调用 create_portfolio_group 或 stock_group_list 确认分组信息。

rename_portfolio_group — 重命名自选分组

⚠️ 原名称与新名称均不能为空。

7.4 专业投研资料（8 个工具）

research_hot_data_query — 查询投研热门数据

⚠️ startTime 和 endTime 时间间隔不能超过 90 天。

search_popular_roadshow — 查询热门路演

searchDomesticReports — 搜索内资研报

💡 后端为向量数据库，请使用完整的自然语言问题，明确公司名称、行业主题、事件背景。

searchForeignReports — 搜索外资研报

💡 推荐使用英文描述检索意图。

searchRoadshowSummary — 搜索路演纪要

💡 如果用户输入的是股票代码，需补充公司简称一起搜索。

searchAnnouncementReport — 搜索上市公司公告

⚠️ 公司名称通过 fullCode 指定，禁止在 query 中罗列公司名称。

searchAnalystComments — 搜索分析师点评

research_query — 投研数据综合查询

研报搜索动态时间窗口规则

适用于 searchDomesticReports / searchForeignReports / searchRoadshowSummary / searchAnalystComments 的 start_time。

用户明确提到"今天"、"本周"、"本月"、"本季度"时，锚定到精确日期（优先于动态窗口）。

7.5 公众号管理（3 个工具）

official_account_subscription_list — 查询公众号订阅列表

wechat_opinion_list — 查询微信群消息

wechat_article_query — 查询公众号文章

7.6 文档管理（6 个工具）

document_access — 访问文档内容

document_search — 搜索云文档列表

searchMyKnowledge — 检索个人共享知识库

searchMySummary — 检索个人纪要

searchMyDoc — 检索个人文档

document_upload — 上传文件/文件夹

*fileList 和 folderList 至少传一项。

7.7 量化回测（3 个工具）

backtest_submit — 提交量化回测任务

💡 港股池(hsi/all_hk)未显式指定 benchmark 时会自动对齐到 hsi。

{
  "prompt": "低估值高股息策略：选取市盈率低于15且股息率高于5%的股票，等权持有",
  "universe": "all_a",
  "benchmark": "hs300",
  "start_date": "2023-01-01",
  "end_date": "2026-07-01",
  "holding_period": 20,
  "n_groups": 5
}

backtest_tasks_status — 查询回测任务状态

backtest_task_list — 查询回测任务记录

8. 枚举值速查

股票代码格式

市场类型 (marketType)

报告期类型 (reportType)

统计口径 (type)

公告业绩期间 (labelList)

宏观指标九分类 (category)

宏观指标国家/地区 (country)

期货市场 (market)

代录状态 (recordStatus)

代录类型 (recordType)

代录来源 (recordSource)

会议状态 (status — self_meeting_list)

会议类型 (typeForUser — self_meeting_list)

微信群消息类型 (type — wechat_opinion_list)

公众号文章范围 (wechatArticleScope)

文件类型 (fileType — document_search/upload)

来源类型 (sourceType / sourceList)

research_query 的 type 参数

research_hot_data_query 的 contentType

回测股票池 (universe)

回测基准指数 (benchmark)

申万一级行业列表

食品饮料、传媒、机械设备、通信、轻工制造、计算机、海外研究、钢铁、电子、电力设备、有色金属、交通运输、汽车、医药生物、建筑材料、房地产、建筑装饰、农林牧渔、纺织服饰、国防军工、社会服务、基础化工、公用事业、煤炭、家用电器、商贸零售、综合、北交所、中小市值、银行、非银金融、宏观、石油石化、美容护理、环保、固收、策略、金融工程