← 返回目录

Unusual Whales MCP

官方

官方 Unusual Whales MCP 服务器，提供 100+ 市场数据端点

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 168 / 230
Stars: ★ 91 热门
传输方式: SSE · Streamable HTTP
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 53 天前
工具数: 7

47FMRS · D

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

最强项 · 文档质量 11/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

9/20

文档质量

11/20

安装易用性

10/20

查看各项评分依据

可靠性 7/20: README详细列出了工具和端点，但仓库中没有服务器源代码，无法验证初始化、工具注册或错误处理。本地使用npx @unusualwhales/mcp，但未提供该包的源码，且没有测试或CI配置。因此，基于静态证据，可靠性得分较低。
安全与权限 10/20: 文档要求使用API密钥，远程端点使用Bearer头，但未明确说明密钥存储方式或是否有最小权限。README未提及密钥轮换或泄露应对措施。仓库中没有发现恶意代码，但由于无法查看实现，存在未知风险。
维护活跃度 9/20: 仓库活跃，有近期的提交和发布，且有MIT许可证。但有8个未解决的问题，且没有看到安全响应渠道。维护尚可，但治理和版本控制存在一些缺口。
文档质量 11/20: README提供了详细的安装步骤、客户端配置示例和故障排除表，对API密钥和配置变量有清晰说明。但未提供工具参数、速率限制和费用信息，也没有展示配置如何影响实际使用的证据。
安装易用性 10/20: README提供了针对Claude Code、Desktop、Cursor、VS Code、Windsurf的远程和本地安装说明，步骤清晰。但本地模式需要Node.js 20+，且远程模式需要额外的客户端配置，对某些用户可能不便。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

UW_API_KEY 必填密钥 Unusual Whales API 密钥，在 unusualwhales.com/settings/api-dashboard 获取，本地模式必需。

其他可选配置项（5 个）

UW_RATE_LIMIT_PER_MINUTE 可选每分钟最大请求数，默认 120，可选。

UW_MAX_RETRIES 可选失败请求的重试次数，默认 3，可选。

UW_CIRCUIT_BREAKER_THRESHOLD 可选熔断前的失败次数阈值，默认 5，可选。

UW_CIRCUIT_BREAKER_RESET_TIMEOUT 可选熔断后重试前的等待毫秒数，默认 30000，可选。

LOG_LEVEL 可选日志详细程度（debug/info/warn/error），默认 info，可选。

在 unusualwhales.com/settings/api-dashboard 获取 API 密钥。
使用远程（推荐）或本地方式配置客户端。
远程：使用 URL https://api.unusualwhales.com/api/mcp 并添加 Authorization: Bearer YOUR_KEY 头。
本地：配置命令 npx -y @unusualwhales/mcp 并设置环境变量 UW_API_KEY。
配置后完全退出并重新打开 AI 助手。

claude_desktop_config.json

{
  "mcpServers": {
    "unusualwhales": {
      "command": "npx",
      "args": ["-y", "@unusualwhales/mcp"],
      "env": {
        "UW_API_KEY": "YOUR_KEY"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "unusualwhales": {
      "command": "npx",
      "args": [
        "-y",
        "@unusualwhales/mcp"
      ],
      "env": {
        "UW_API_KEY": "YOUR_KEY"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add unusualwhales -e UW_API_KEY=YOUR_KEY -- npx -y @unusualwhales/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

连接后在客户端工具列表中确认出现 get_fundamental_breakdown 等工具，或提问 "AAPL 今天的期权资金流怎么样？"，若能返回数据即证明配置成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

AAPL 今天的期权资金流怎么样？
获取 NVDA 的基本面拆解和财报历史
显示 TSLA 的 RSI 和 MACD 技术指标
给我看最近的国会交易

工具能力 7

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。

使用场景

查看 AAPL 今日期权流

获取最新国会交易

查看 TSLA 暗池活动

获取 SPY 期权最大痛点

深度分析 NVDA 的期权、暗池和内幕交易

支持客户端

Claude

Claude Desktop

Cursor

VS Code

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

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