为 GitHub Copilot 提供 GitHub Copilot 金融数据

Q: 如何在 VS Code 中将 Narwhal 添加到 GitHub Copilot？

创建 .vscode/mcp.json，包含一个 HTTP 服务器条目、Narwhal URL，以及由密码输入支持的 Authorization 标头。从 MCP: List Servers 启动服务器，并在 VS Code 询问时提供你的密钥。

Q: Copilot CLI 把我的 Narwhal 密钥存在哪里？

添加命令执行后，Copilot CLI 会将密钥存储在 ~/.copilot/mcp-config.json 中。请保持该文件私密，不要纳入版本控制，也不要把密钥粘贴到提示词或 URL 中。

GitHub Copilot 可以在 VS Code 或 Copilot CLI 中通过 MCP 调用 Narwhal，工具为只读，REST 和 MCP 共用一份额度。VS Code 可以提示输入密钥并安全存储。Copilot CLI 会把密钥写入其配置文件，因此请保持该文件私密。

快速开始

在 https://narwhalapi.com/signup 获取免费的 Narwhal 密钥，不要把它写进提示词或 URL。
在 Business 或 Enterprise 上，请先让管理员在 Copilot 策略中启用 MCP 服务器，然后再连接。
对于 VS Code，请使用 1.99 或更高版本，并将服务器配置添加到 .vscode/mcp.json。
通过 MCP: List Servers 启动 Narwhal，并在密码提示中输入你的密钥。
对于 Copilot CLI，请使用单独的添加命令，并用 /mcp show narwhal 检查该条目。

MCP 配置

VS Code 配置使用带有 HTTP 条目的 servers 对象，并用密码输入提供标头。单独的 CLI 命令则在 Copilot CLI 中注册同一个托管端点。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "NARWHAL_API_KEY",
      "description": "Narwhal API Bearer key",
      "password": true
    }
  ],
  "servers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:NARWHAL_API_KEY}"
      }
    }
  }
}

copilot mcp add --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

VS Code 会在服务器首次启动时询问密钥并安全存储。CLI 会把密钥写入 ~/.copilot/mcp-config.json；请保持该文件私密，不要纳入版本控制。

可用工具

GitHub Copilot 通过一个 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 汇率历史。
获取可用的棕榈油价格历史。
查找英国下一个公共假日。
获取美国最新的 GDP 增长值。

常见工作流

查看德国最新的 GDP 观测值

要获取德国最新的 GDP 观测值，请选择德国并调用经济工具 economics_get_gdp。

查看货币对汇率

GBP/USD 历史数据来自 fx_get_rate_history，以 GBP 为基础货币，["USD"] 作为报价货币列表。将 start_date 设为 2026-09-08，end_date 设为 2026-09-14。

在 Copilot 中查看棕榈油数据

你需要哪个新鲜果串序列？通过 commodities_list_palmoil_physical_series 选择一个，然后把其序列 ID 提供给 commodities_get_palmoil_physical_observations，按原生期间获取价格。

围绕英国公共假日做计划

向 calendars_get_next_holiday 提供英国和起始日期，即可查找该日期当天或之后下一个已公布的假日。

提示

在 VS Code 中使用类型为 promptString 且带 "password": true 的 input，并在 Authorization 标头中以 ${input:NARWHAL_API_KEY} 引用它。
从命令面板打开 MCP: List Servers，即可启动、停止或重启 Narwhal 并查看其输出。
如需在会话之外查看已注册的服务器，可用 copilot mcp get narwhal 检查 CLI 条目。
Business 和 Enterprise 的 MCP 策略默认关闭；Copilot Free、Pro、Pro+ 和 Max 不受其管辖。

常见问题

如何在 VS Code 中将 Narwhal 添加到 GitHub Copilot？

创建 .vscode/mcp.json，包含一个 HTTP 服务器条目、Narwhal URL，以及由密码输入支持的 Authorization 标头。从 MCP: List Servers 启动服务器，并在 VS Code 询问时提供你的密钥。

Copilot CLI 把我的 Narwhal 密钥存在哪里？

添加命令执行后，Copilot CLI 会将密钥存储在 ~/.copilot/mcp-config.json 中。请保持该文件私密，不要纳入版本控制，也不要把密钥粘贴到提示词或 URL 中。

Copilot 需要管理员启用 MCP 吗？

Business 和 Enterprise 需要管理员在 Copilot 策略中启用 MCP 服务器。该策略默认关闭，且不适用于 Copilot Free、Pro、Pro+ 或 Max。

故障排查

症状	检查
Narwhal 没有出现在 VS Code 中	检查 `.vscode/mcp.json` 中有 `servers` 对象，且有一个带 `"type": "http"` 的条目，然后打开 `MCP: List Servers`。
调用返回 `401 invalid_api_key`	确认所提供的密钥有效，且 Authorization 值包含 `Bearer`、一个空格和密钥。
Business 或 Enterprise 账户的 MCP 被阻止	请管理员在 Copilot 策略中检查 MCP 服务器，并为你的账户启用。
CLI 条目缺失或使用了错误的 URL	用 `copilot mcp get narwhal` 检查，并使用不带结尾斜杠的 https://api.narwhalapi.com/mcp。

此页面对你有帮助吗?