把 Cursor 金融数据带进 Cursor

Q: Cursor 可以从 envFile 加载我的密钥吗？

不能。Cursor 中的远程服务器不支持 envFile。请在 shell 配置文件或系统环境中设置该变量，并在标头中以 ${env:NARWHAL_API_KEY} 引用它。

Cursor 可以通过远程 MCP 服务器调用 Narwhal，REST 和 MCP 共用一个 API 密钥和额度。启动 Cursor 之前先把密钥存入环境变量，然后在工作时请求经济数据。同一连接还包含汇率、大宗商品数据和其他实时工具组。

快速开始

从 https://narwhalapi.com/signup 获取你的免费密钥。
在启动 Cursor 之前，在 shell 配置文件或系统环境中设置 NARWHAL_API_KEY。
将远程服务器配置添加到 .cursor/mcp.json（仅用于当前项目）或 ~/.cursor/mcp.json（用于所有项目）。
在侧边栏的 Customize 下启用 Narwhal，并查看 Available Tools。

MCP 配置

远程条目使用 url 和 headers，并在 Authorization 标头中使用 ${env:NARWHAL_API_KEY}。Cursor 从其环境中读取该引用；远程 MCP 服务器不支持 envFile。

{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

将配置保存在你需要的范围对应的项目文件或用户文件中。修改系统或 shell 环境后，请重启 Cursor，使其进程在连接之前就拿到密钥。

可用工具

Cursor 通过一个 Narwhal 连接即可使用所有只读工具组。初始化和工具发现免费，每次成功的工具调用计为一次调用，从与 REST 相同的额度中扣费。

分组	可查询的内容	工具
经济指标	可按国家查询 CPI、通货膨胀、失业率、劳动力参与率、GDP、GDP 增长和贸易数据；各指标的覆盖范围不同。	`economics_get_cpi` `economics_get_inflation` `economics_get_unemployment` `economics_get_labour_force_participation` `economics_get_gdp` `economics_get_gdp_growth` `economics_get_trade` `economics_get_cpi_history` `economics_get_inflation_history` `economics_get_unemployment_history` `economics_get_labour_force_participation_history` `economics_get_gdp_history` `economics_get_gdp_growth_history` `economics_get_trade_history` `economics_read_series_observations` `economics_search_catalogue` `economics_read_catalogue_series` `economics_read_catalogue_observations` `economics_read_catalogue_latest_batch` `economics_get_policy_rate` `economics_get_policy_rate_history` `economics_get_central_bank_reserves` `economics_get_central_bank_balance_sheet`
货币汇率	可查询某个货币对的当前汇率、历史汇率、货币换算和汇率 K 线。	`fx_get_rates` `fx_get_rate_history` `fx_convert_currency` `fx_get_rate_bars`
大宗商品价格	可查询黄金、白银、铂金、钯金、铜、WTI原油和布伦特原油的现货价格及其价格历史，以及棕榈油实物价格（毛棕榈油和棕榈鲜果串）。	`commodities_get_spot_price` `commodities_get_price_history` `commodities_list_palmoil_physical_series` `commodities_get_palmoil_physical_price` `commodities_get_palmoil_physical_observations` `commodities_list_physical_series` `commodities_get_physical_series` `commodities_get_physical_latest` `commodities_get_physical_observations`
发布与事件	在准备国家简报之前，可先查询官方经济数据的发布日期和事件详情。	`economics_list_releases` `economics_get_release` `events_list` `events_get`
节假日	可按国家查询公共假日、某一天的假日，或下一个假日。	`calendars_list_holidays` `calendars_get_holidays_on_date` `calendars_get_next_holiday`
预测市场概率	可查询预测市场的主题和事件（含数值型、极值型、时间型和二元结果）、它们的历史数据，以及按决策机构划分的政策路径。	`predictions_list_topics` `predictions_get_topic` `predictions_list_events` `predictions_get_scalar` `predictions_get_extreme` `predictions_get_timing` `predictions_get_binary` `predictions_get_scalar_history` `predictions_get_extreme_history` `predictions_get_timing_history` `predictions_get_binary_history` `predictions_get_policy_path` `predictions_get_policy_path_history`
国债收益率	通过同一个 Narwhal 连接，可查询美国、英国、德国、日本、加拿大、瑞典、挪威、澳大利亚和欧元区的政府债券收益率曲线。	`economics_get_yield_curve` `economics_get_yield_curve_history`

示例提示词

获取加拿大最新的失业率。
显示当前的 GBP/USD 汇率。
获取可用的棕榈油价格历史。
查一下美国下一次官方 CPI 的发布日期。
列出日本今年的公共假日。

常见工作流

按期间跟踪加拿大失业率

让 Cursor 使用 economics 组中的 economics_get_unemployment_history 获取加拿大的失业率观测值。历史数据按期间列出观测值。

换算前先查看汇率

当前 GBP/USD 汇率是你需要的吗？以 GBP 为基础货币、USD 为报价货币调用 fx_get_rates。

在 Cursor 中查看棕榈油历史

让 Cursor 使用 commodities_list_palmoil_physical_series 查找棕榈油序列，然后用所选序列 ID 通过 commodities_get_palmoil_physical_observations 读取各期间的观测值。

围绕发布日期规划简报

用 economics_list_releases 规划简报：选择美国，并使用不超过 366 天的窗口。条目包含计划的发布日期和时间。

提示

想让 Cursor 使用特定操作时，可直接指明工具名称；也可以描述你需要的数据，再查看 Available Tools。
在标头中使用环境变量引用，不要把实际密钥写入 .cursor/mcp.json，项目文件被共享时也是如此。
需要连接错误详情时，用 Cmd+Shift+U 打开 Output 面板并选择 MCP Logs。
随着项目需求变化，可在侧边栏的 Customize 中启用、停用或管理 Narwhal 服务器。

常见问题

如何将 Cursor 连接到 Narwhal MCP？

在 Cursor 的 MCP 配置中添加一个远程服务器条目，包含 Narwhal URL 和 Authorization Bearer 标头。启动 Cursor 之前先设置 NARWHAL_API_KEY，然后启用该服务器并查看 Available Tools。

Cursor 可以从 envFile 加载我的密钥吗？

不能。Cursor 中的远程服务器不支持 envFile。请在 shell 配置文件或系统环境中设置该变量，并在标头中以 ${env:NARWHAL_API_KEY} 引用它。

在 Cursor 中调用 Narwhal 的费用是多少？

每次成功的工具调用计为一次调用，工具发现免费。每个账户在前 12 个月内每月可获得 10 美元免费额度，短时间窗口限制为每分钟 50 个请求。

故障排查

症状	检查
Narwhal 没有出现在 Available Tools 下	检查项目或用户的 `.cursor/mcp.json`，然后在侧边栏的 Customize 下启用该服务器。
连接返回 `401 invalid_api_key`	确认在启动 Cursor 的环境中，`NARWHAL_API_KEY` 包含有效的密钥，然后重启 Cursor。
远程服务器无法读取 envFile	将变量移到你的 shell 配置文件或系统环境中，并在 Authorization 标头中使用 `${env:NARWHAL_API_KEY}`。
修改 URL 后连接失败	请使用不带结尾斜杠的 https://api.narwhalapi.com/mcp，然后在 Output 面板中查看 MCP Logs。

此页面对你有帮助吗?