浏览全部文档

用 Gemini 工具调用 Gemini 金融数据 API

Antigravity CLI 可以通过 Streamable HTTP 和 Authorization Bearer 标头连接到 Narwhal。个人用户已从 Gemini CLI 迁移到 Antigravity CLI，其命令为 agy。在仍可使用 Gemini CLI 的地方，它也可以连接，但使用自己的配置格式。

快速开始

  1. 在 https://narwhalapi.com/signup 获取免费的 Narwhal 密钥，不要把它写进提示词或 URL。
  2. 对于 Antigravity CLI，请打开 ~/.gemini/config/mcp_config.json 或工作区文件 .agents/mcp_config.json。
  3. 添加包含 serverUrl 和 Authorization Bearer 标头的远程条目，并确保该文件保密。
  4. 用 /mcp 验证 Antigravity 连接。
  5. 在可使用 Gemini CLI 的地方，运行带 -s user 的添加命令，将密钥保存在用户设置中。

MCP 配置

Antigravity CLI 使用 serverUrl 表示 Streamable HTTP，并使用 headers 对象。Gemini CLI 的添加命令使用 -s user、HTTP 传输和 Authorization Bearer 标头。

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "narwhal": {
      "serverUrl": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
      }
    }
  }
}
Gemini CLI
gemini mcp add -s user --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

Antigravity CLI 的文档没有说明标头中的环境变量展开，因此其配置文件中存放的是密钥值。无论该文件位于用户配置还是工作区中，都要保密，且不要纳入版本控制。

可用工具

两个受支持的 CLI 都能通过一个 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

示例提示词

  • 获取日本最新的通胀值。
  • 显示当前 USD/IDR 汇率。
  • 获取当前黄金现货价格。
  • 查一下美国下一次官方 CPI 的发布日期。
  • 列出印度尼西亚今年的公共假日。

常见工作流

准备日本通胀简报

日本通胀可通过任一 CLI 中的 economics_get_inflation 获取。选择日本即可获得最新公布的百分比变化。

兑换货币前先查看汇率

用 fx_get_rates 查看 USD/IDR，以 USD 为基础货币、IDR 为报价货币，获取当前指示性汇率。

查看大宗商品价格，为你的分析做准备

commodities_get_spot_price 接受铜和报价货币，结果为当前指示性现货价格。

查看下一次 CPI 发布的时间

在 economics_list_releases 请求中包含美国和最长 366 天的日期窗口，即可找到下一次官方 CPI 发布。

提示

  • 在 Antigravity CLI 中请使用 serverUrl；那里不支持 httpUrl 和旧版 SSE 传输。
  • 对于 Gemini CLI，-s user 会将密钥保存在 ~/.gemini/settings.json 中；默认的项目范围则会写入仓库的 .gemini/settings.json。
  • Gemini CLI 设置在 mcpServers 下使用带有 httpUrl 和 headers 的条目。

常见问题

个人 Gemini 用户还能使用 Gemini CLI 吗？

个人用户已从 Gemini CLI 迁移到 Antigravity CLI，其命令为 agy。在仍可使用 Gemini CLI 的地方，它有单独的配置格式。

Antigravity CLI 为 Narwhal 使用哪个 URL 字段？

Antigravity CLI 使用 serverUrl，指向 Streamable HTTP 端点 https://api.narwhalapi.com/mcp。在 headers 中添加 Authorization Bearer 标头，并用 /mcp 验证连接。

Antigravity 可以从环境变量引用中读取密钥吗？

文档没有说明标头中的环境变量展开，因此文件中存放的是密钥值。请保持用户或工作区配置文件私密，并不要纳入版本控制。

故障排查

症状检查
Narwhal 没有出现在 Antigravity CLI 中检查用户或工作区的 mcp_config.json 条目，确认它使用 serverUrl，并查看 /mcp。
服务器返回 401 invalid_api_key确认标头包含 Bearer、一个空格和有效的密钥，而不是未展开的环境变量引用。
使用 httpUrl 的 Antigravity 连接失败将远程条目改为 serverUrl 和 Streamable HTTP；Antigravity 不支持 httpUrl 或旧版 SSE 传输。
Gemini CLI 不再为该账户层级提供服务个人账户请使用 Antigravity CLI，并遵循其配置格式，而不是 Gemini CLI 的设置格式。

此页面对你有帮助吗?