关于 Narwhal
Narwhal 提供金融与经济数据 API,并通过托管 MCP 服务向客户端提供数据工具。其 Node.js 桥接程序把本地命令式客户端的请求转发到服务端,也可直接连接远程服务。
主要功能
- 01提供金融与经济数据工具
- 02通过 stdio 转发请求
- 03使用 API 密钥进行 Bearer 认证
- 04支持直接连接托管服务
- 05可配置基础 URL 和超时
适用场景
- 01从 MCP 客户端访问 Narwhal 数据工具
- 02在本地命令式客户端中连接托管服务
- 03为请求配置 API 密钥和超时
MCP 相关
提供托管 MCP 服务,客户端可直接通过远程连接访问,也可使用 @narwhalapi/mcp 的 stdio 桥接程序转发请求;工具列表由服务端提供。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.narwhalapi.com/mcpclaude mcp add --transport http com-narwhalapi https://api.narwhalapi.com/mcp{"mcpServers":{"com-narwhalapi":{"type":"http","url":"https://api.narwhalapi.com/mcp"}}}在 Cursor 中打开{"servers":{"com-narwhalapi":{"type":"http","url":"https://api.narwhalapi.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-narwhalapi":{"type":"http","url":"https://api.narwhalapi.com/mcp"}}}{"mcpServers":{"com-narwhalapi":{"serverUrl":"https://api.narwhalapi.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Narwhal API MCP 桥接器
@narwhalapi/mcp 可将启动本地命令的 MCP 客户端连接到托管的 Narwhal API MCP 服务。它作为 stdio 桥接器运行,并使用 API 密钥作为 Bearer 令牌,将每个请求转发到
https://api.narwhalapi.com/mcp。桥接器本身不提供任何工具;工具列表由服务提供。
安装
需要 Node.js 20 或更高版本。
npm install @narwhalapi/mcp
快速入门
将此配置添加到支持本地命令的 MCP 客户端:
{
"mcpServers": {
"narwhal": {
"command": "npx",
"args": ["-y", "@narwhalapi/mcp"],
"env": {
"NARWHAL_API_KEY": "your-key"
}
}
}
}
将 your-key 替换为你的 API 密钥。MCP 客户端使用
npx 启动桥接器,并通过 stdio 与其通信。随后,请求会携带该密钥发送到托管服务。
配置
必须设置 NARWHAL_API_KEY。如果未设置,桥接器会显示一条消息并退出。
NARWHAL_BASE_URL 的默认值为 https://api.narwhalapi.com。
NARWHAL_TIMEOUT 用于设置请求超时时间(毫秒),默认值为
10000。日志仅写入 stderr,stdout 则留作 MCP 通信使用。
远程连接
支持远程服务的 MCP 客户端可以直接连接到
https://api.narwhalapi.com/mcp。使用你的 API 密钥配置请求头
Authorization: Bearer <key>。直接连接会使用托管服务,无需启动本地桥接器。请选择 MCP 客户端支持的连接方式。
链接:文档
采用 MIT 许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。