把經濟數據帶進 Cursor MCP

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 找出棕櫚油數列，再用 commodities_get_palmoil_physical_observations 與選定的數列 ID 讀取各期間的觀測值。

圍繞公布日期規劃簡報

以 economics_list_releases 規劃簡報：選擇美國，並使用不超過 366 天的區間。項目包含預定的公布日期與時間。

使用提示

若要讓 Cursor 使用特定操作，可直接指定工具名稱，或描述你需要的資料，再檢查 Available Tools。
在標頭中使用環境變數參照，就能讓實際金鑰不出現在 .cursor/mcp.json 中，即使專案檔案是共用的也一樣。
若需要連線錯誤的詳細資訊，請按 Cmd+Shift+U 開啟輸出面板，並選擇 MCP Logs。
隨著專案需求變化，可在側邊欄的 Customize 下啟用、停用或管理 Narwhal 伺服器。

常見問題

如何將 Cursor 連接到 Narwhal MCP？

在 Cursor 的 MCP 設定中新增一筆遠端伺服器項目，包含 Narwhal 網址與 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}`。
編輯網址後連線失敗	請使用確切的 https://api.narwhalapi.com/mcp，結尾不要加斜線，然後在輸出面板中檢查 MCP Logs。

此頁面對你有幫助嗎?