Bullrundata Market Intelligence

市场情报 MCP 服务

衰退概率、行业轮动、机构持仓、宏观连锁情景分析、房地产计算器和实时经济数据，适用于 Claude、ChatGPT、Cursor 及任何 MCP 客户端。

由 BullrunData API 提供支持。

快速开始（托管版——推荐）

托管端点 https://bullrundata.com/api/mcp 是最快的接入方式。无需安装，自动更新，且下方列出的每种 MCP 客户端都原生支持它。

在 bullrundata.com 免费获取 API 密钥——每天可调用 100 次，无需信用卡。

Claude Code

claude mcp add --transport http bullrundata https://bullrundata.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

添加到 ~/.cursor/mcp.json（或项目本地的 .cursor/mcp.json）：

{
  "mcpServers": {
    "bullrundata": {
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

添加到 .vscode/mcp.json（工作区）或你的用户级 mcp.json：

{
  "servers": {
    "bullrundata": {
      "type": "http",
      "url": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "bullrundata": {
      "serverUrl": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Claude Desktop 目前尚不原生支持 HTTP MCP——可通过 mcp-remote 转接。添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "bullrundata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bullrundata.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

你也可以完全跳过该标头——首次连接时，mcp-remote 会在浏览器中打开 OAuth 流程，并自动配置免费层级的密钥。

{
  "mcpServers": {
    "market-intelligence": {
      "command": "npx",
      "args": ["-y", "@bullrundata/market-intelligence"],
      "env": {
        "BULLRUNDATA_API_KEY": "your-api-key"
      }
    }
  }
}

claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligence

可用工具

宏观情报

市场与机构

房地产计算器

经济数据

Cascade Engine（宏观情景分析）

**可用的催化剂：**石油供应冲击、美元流动性紧缩、美联储紧急降息、美国经济衰退、中国—台湾局势升级、收益率曲线倒挂、信贷市场冻结、新兴市场货币危机、贸易战升级、主权债务危机

对话示例

“当前的衰退风险有多大？”

Claude 使用 recession_probability 并返回：

当前衰退概率为 37.9%（中等风险）。美联储立场：中性。市场阶段：中周期。建议：信号不一，需谨慎。开始转向防御型配置。

“现在以 $450K 购买投资房产是好时机吗？”

Claude 使用 investment_property_analysis + interest_rates：

以 $450K 的价格、20% 的首付款和 7% 的利率计算，月现金流为 $287。资本化率：5.3%。现金回报率：4.2%。DSCR：1.18（健康）。当前 30Y 抵押贷款利率：6.38%。

“市场的风险偏好/规避信号是什么？”

Claude 使用 sectors_rotation + institutional_cftc：

板块轮动信号：RISK_ON。周期性板块领涨，防御性板块落后。机构仓位与风险偏好一致。策略：继续超配周期性板块，并留意轮动是否出现破坏迹象。

“如果油价涨到 $120，会发生什么？”

Claude 使用 cascade_analysis + sectors_rotation：

石油供应冲击的连锁反应：美元需求激增（必然）-> 亚洲外汇储备减少（可能，数周内）-> 亚洲股市资金流出（可能）-> 亚洲被迫加息（很可能，数月内）。当前板块轮动：RISK_ON，但能源板块落后，说明市场尚未计入供应风险。策略：配置通胀对冲工具并储备现金。关注美联储互换额度的使用情况，以判断系统性风险信号。

配置

对于托管端点，身份验证信息通过客户端配置中的 Bearer 标头传递（见上文“快速开始”），或在首次连接时通过 OAuth 协商——无需环境变量。

对于本地 npx 安装：

定价

故障排除

安装后 Claude 中未显示工具

1. 确认 MCP 服务已注册：在 Claude Desktop 中，检查 设置 → 连接器（或 开发者）中的 market-intelligence。在 Claude Code 中，运行 claude mcp list。
2. 完全重启 Claude Desktop（退出，而不只是关闭窗口）——连接器更改不会热重载。
3. 确认已设置 BULLRUNDATA_API_KEY 环境变量且其有效。若未设置，工具会在首次调用时失败。
4. 如果直接使用远程服务（https://market.bullrundata.com/mcp），请在浏览器提示时完成 OAuth 流程——Claude 需要 Bearer 令牌才能调用工具。

工具返回 401 Unauthorized

你的 API 密钥缺失、已过期或处于非活动状态。请前往 bullrundata.com/login 获取新密钥。对于远程服务流程，请通过 OAuth 页面重新进行身份验证；连接器会在首次连接时自动配置免费版密钥。

429 Too Many Requests

你已达到每日速率限制。限制于 UTC 时间 00:00 重置。

前往 bullrundata.com/pricing 升级，或等待 UTC 时间重置。

OAuth 流程卡住或超时（远程服务）

远程服务使用 GitHub OAuth。如果重定向卡住：

1. 确认已允许 market.bullrundata.com 和 claude.ai 使用 Cookie 和弹出窗口
2. 尝试在无痕窗口中授权（清除缓存的 OAuth 状态）
3. 检查浏览器中访问 https://market.bullrundata.com/.well-known/oauth-authorization-server 是否返回 200

首次请求较慢（约 2–4 秒）

这是无服务器部署的冷启动延迟。同一会话中的后续请求应在 500 毫秒内响应。

cascade_analysis 返回“live data unavailable”

级联工具可选择使用实时 BullrunData 市场数据进行增强。如果上游 API 暂时无法访问，你仍会获得完整的催化剂树，只有实时数据叠加层会被跳过。传入 include_live_data: false 可完全跳过实时数据获取。

工具返回过时数据

经济指标每天会刷新多次。请在 dashboard_summary 中查看 data_freshness，了解上次刷新的时间戳。

仍然无法解决

请在 GitHub Issues 中提交问题，或发送邮件至 [email protected]，并提供：工具名称、完整错误消息和大致时间戳。

支持

• 网站：bullrundata.com
• 文档：bullrundata.com/docs
• 问题反馈：GitHub Issues

许可证

Elastic License 2.0 — 请参阅 LICENSE。

你可以使用、修改和重新分发本软件。你不得将其作为托管或管理服务提供，且该服务不得让用户访问本软件的大量功能或特性。