Bullrun-mcp 是 Bullrun 托管 MCP 连接器的公开元数据与连接文档仓库。Bullrun 主要是一项托管服务——正常使用无需安装任何内容，也无需管理 API 密钥。用户只需将 MCP 客户端指向远程端点，并使用 Google 登录。该仓库包含连接器的公开元数据（server.json）、连接文档，以及用于目录/安全检查的 MCP 层本地 stdio 构建。Bullrun 应用与数据服务另行维护。
用途 该连接器将 Claude（及其他 MCP 客户端）转变为研究分析师，覆盖全球股票、ETF、公司风险、全球宏观背景以及用户自己的投资组合，并内置 Bullrun 自有的机器学习估值模型。
主要能力
- Bullrun 估值模型：Bullrun 自有的 LightGBM 模型，每晚对全球股票范围重新评分。估值模型预测基本面相似的企业一年后通常交易的市盈率（或对无盈利公司使用市销率）；缺口为该模型典型倍数相对当前倍数减去一。预测模型是一个相对的 1 年回报排名信号。两者均基于季度和年度财务数据运行，因此大多数非美国公司也被覆盖。估值缺口描述的是股票相对于基本面相似公司的定价情况。在前进测试（walk-forward）中，它并未预测未来回报，且工具在每次响应中都会说明这一点：它是决策的背景信息，而非价格目标。
- 公司风险与关系：风险区间分为 Contained → Normal → Elevated → Stretched → Acute，描述的是测量到的压力，绝非买入/卖出观点。没有读数的表盘报告为 unmeasured（未测量），而非 safe（安全）。
- 全球市场与宏观：为欧洲投资者实际挑选基金的方式而构建——按 ISIN、按跟踪指数、按总成本——并将同一基金在多个交易所的重复项合并，使一只在六个交易所上市的基金呈现为一个选择而非六个。
- 个人投资组合：客户端提示菜单中提供可选的起点：stock_deep_dive（单个股票代码的基本面、估值模型、风险表盘和关系）、market_briefing（市场、宏观和本周风险变动）、build_portfolio、suggest_positions 和 analyze_portfolio。
使用方式 Claude（网页、桌面、移动端）——需要付费 Claude 套餐：设置 → 连接器 → 添加自定义连接器；命名为 Bullrun，粘贴 https://mcp.bull-run.org/mcp 并添加；点击连接并完成 Google 登录/授权步骤。Cursor、VS Code 和 MCP Inspector 的完整设置见 docs/mcp-connect.md。 公开市场数据工具对任何已连接的客户端都可用。投资组合工具在 Google 登录后解析用户自己的 Bullrun 账户；两个草稿工具需要 Bullrun Pro 账户。成功的研究结果会包含指向 Bullrun 上匹配页面的上下文链接。股票筛选链接保留规范化筛选器、报告窗口、上市范围和排序。风险看板链接保留机制、多个区间、覆盖范围和排序。链接描述会披露目标页面无法重现的设置。客户端接收 platformLink（label、url、description）、webPage、可读 Markdown 和 MCP resource_link；助手是否显示链接取决于客户端。保存的投资组合草稿直接链接到确切的待处理草稿。登录会保留目的地，接受或丢弃草稿仍由用户选择。打开链接绝不会改变持仓。链接带有固定的活动标签和来源工具名称，不包含令牌、账户身份、投资组合值或自由文本简报。网站活动和已完成的工具调用与上游 API 请求分开计量。可运行 npm test 进行连接器的 URL、遥测、身份验证和集成检查，或 npm run test:links 进行针对性的交接检查。
适用场景 例如：“按 Bullrun 估值模型，ASML 贵吗？其最大风险是什么？”“苹果的供应商有哪些，其中哪些大部分收入依赖苹果？”“哪些美国大公司目前杠杆处于 stretched 或 acute 状态？”“今早简要介绍全球市场，重点关注欧洲。”“按政府债务对 G7 国家排名，并显示意大利自 2010 年以来的 10 年期收益率。”“找到相对基本面最便宜的德国股票。”可在 Bullrun 中继续研究：探索公司图表和网络、调整股票筛选、比较基金，或从已有答案打开宏观图表。
限制 估值缺口在前进测试中未预测未来回报。风险区间仅为测量压力，不是买卖观点。无读数报告为未测量。投资组合工具需要 Google 登录解析账户；两个草稿工具需要 Bullrun Pro 账户。托管端点上的投资组合与草稿工具需要 Bullrun OAuth 令牌，在匿名 stdio 检查中返回需要身份验证的错误。公开市场数据工具无需凭据。
身份验证与隐私 该服务器是 OAuth 2.0 受保护资源（RFC 9728）。首次连接时，客户端运行自动发现握手，并引导用户完成 Google 登录；授权后，按用户工具解析其 Bullrun 账户。MCP 层是一个薄代理，没有自己的数据库——读取工具返回市场数据和用户自己的持仓，按用户读取工具接受 privacyMode（默认 full，或 weights_only 仅返回相对数字），草稿工具从不改变实时持仓。详见隐私政策。
本地 stdio 构建 上述托管端点是推荐的集成方式。对于需要构建和运行本地 MCP 服务器的目录，该仓库可通过 stdio 运行 MCP 层。公开市场数据工具无需凭据。投资组合和草稿工具在托管客户端中仍需 Bullrun OAuth 令牌，在匿名 stdio 检查中返回需要身份验证的错误。
