瀏覽全部文件

在 Gemini MCP 工具使用 Narwhal

Antigravity CLI 可透過 Streamable HTTP 與 Authorization Bearer 標頭連線到 Narwhal。個人使用者已從 Gemini CLI 轉往 Antigravity CLI，其指令為 agy。仍可使用 Gemini CLI 的環境也能連線，但設定格式不同。

快速開始

  1. 請至 https://narwhalapi.com/signup 取得免費的 Narwhal 金鑰，並避免把金鑰放進提示詞與網址中。
  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？

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 的設定格式。

此頁面對你有幫助嗎?