← 返回目录
U

Unusual Whales MCP

官方
官方 Unusual Whales MCP 服务器,提供 100+ 市场数据端点
GitHub 源仓库 ↗
★ 86 Stars 分类 · 其他 热门 源版本 4f57b36ecc4f
47FMRS · D
可靠性
7/20
安全与权限
10/20
维护活跃度
9/20
文档质量
11/20
安装易用性
10/20

官方 MCP 服务器,提供丰富的市场数据端点,支持远程和本地部署,包含多种客户端配置示例,但需要付费 API 密钥,且远程模式依赖网络服务。

查看 FMRS 评分方法 →

这是 Unusual Whales 官方 MCP 服务器,可让任何 MCP 兼容客户端访问超过 100 个市场数据端点,涵盖期权流、暗池、国会交易、希腊字母风险敞口、波动率等。支持远程托管和本地运行,提供 30+ 个预设分析提示词。

工具能力

get_fundamental_breakdown
基于财报的基本面数据、营收细分、每股收益、股息和资产负债表趋势。
get_stock_financials
合并财务报表,包含利润表、资产负债表、现金流量表和盈利数据。
get_income_statements
利润表历史,可选报表类型过滤。
get_balance_sheets
资产负债表历史,可选报表类型过滤。
get_cash_flows
现金流量表历史,可选报表类型过滤。
get_earnings_history
历史每股收益实际值与预期值及盈利惊喜,可选报表类型过滤。
get_technical_indicator
返回技术指标序列,支持 SMA、EMA、RSI、MACD、BBANDS、STOCH、ADX、ATR、OBV、VWAP、CCI、WILLR、AROON 和 MFI。

安装接入

  1. 在 unusualwhales.com/settings/api-dashboard 获取 API 密钥。
  2. 使用远程(推荐)或本地方式配置客户端。
  3. 远程:使用 URL https://api.unusualwhales.com/api/mcp 并添加 Authorization: Bearer YOUR_KEY 头。
  4. 本地:配置命令 npx -y @unusualwhales/mcp 并设置环境变量 UW_API_KEY。
  5. 配置后完全退出并重新打开 AI 助手。
claude_desktop_config.json
{
  "mcpServers": {
    "unusualwhales": {
      "command": "npx",
      "args": ["-y", "@unusualwhales/mcp"],
      "env": {
        "UW_API_KEY": "YOUR_KEY"
      }
    }
  }
}

选型与风险

适合谁

  • 需要实时市场数据的交易员和投资者
  • 希望用自然语言查询期权流、暗池和国会交易的 MCP 客户端用户
  • 对智能钱流向和机构持仓感兴趣的研究者

不适合谁

  • 不需要市场数据或无法提供 API 密钥的用户
  • 对延迟不敏感、更偏好传统 API 而非 MCP 集成的用户
  • 需要免费或匿名访问的用户

所需权限

  • 需要有效的 Unusual Whales API 密钥(UW_API_KEY)
  • 可访问公共股票基本面和技术指标端点
  • 本地运行时需要 Node.js 20+ 环境
  • 远程模式需要网络访问 api.unusualwhales.com

风险与副作用

  • API 密钥泄露可能导致非法使用或费用产生,请妥善保管
  • 市场数据使用可能受速率限制,默认每分钟 120 次请求
  • 远程服务器可能受网络可用性和服务稳定性影响
  • 数据准确性由数据提供商保证,可能存在延迟或错误

常见排障

  1. 服务器未连接:确认 URL 为 https://api.unusualwhales.com/api/mcp,而不是文档页面
  2. 工具未显示:完全退出并重新打开客户端,检查 JSON 是否有尾随逗号
  3. 401 未授权:检查 API 密钥是否正确且有效;远程配置需正确设置 Authorization 头,本地配置需正确设置 UW_API_KEY 环境变量
  4. npx 未找到(nvm 用户):在 command 字段中使用 npx 的完整路径,并设置 PATH 环境变量

使用场景

查看 AAPL 今日期权流
获取最新国会交易
查看 TSLA 暗池活动
获取 SPY 期权最大痛点
深度分析 NVDA 的期权、暗池和内幕交易

支持客户端

Claude完整支持
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持
Windsurf完整支持