ETF行情监控服务

一个基于Node.js的HTTP MCP服务器,用于监控ETF行情并通过API提供实时报价。

  • by Paleporo
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Paleporo/financial-MCP

使用说明

监控ETF的MCP服务器

该项目在Node.js中提供了一个简单的MCPHTTP服务器,该服务器从配置文件中读取ETF列表,并通过公共API返回当前报价(来源: stooq.pl)。在Windows上也可以在本地工作(Node.js >= 18)。

先决条件

  • 在Windows系统上安装Node.js 18或更高版本
  • 查询公共 API 的 Internet 连接

配置

默认文件 config/etfs.json 包含:

{
  "pollIntervalMs": 60000,
  "market": "us",
  "symbols": ["spy", "qqq", "vti"]
}
  • symbols要监控的ETF列表(小写)。
  • marketstooq API 使用的市场后缀(例如: us, uk, de).
  • pollIntervalMs更新频率以毫秒计。

您可以通过设置环境变量使用不同的路径 ETF_CONFIG.

安装

该项目除了Node.js之外不需要任何外部依赖关系。如果您希望使用 npm 管理您的环境:

npm install

(如果 npm 注册表在公司内受到保护,请确保您可以访问公共依赖项。

开始

npm start

或者,使用自动充电(Node 18+):

npm run dev

一旦启动,服务器就可以在 http://localhost:3000 (可通过环境变量配置端口) PORT).

可用的端点

  • GET /health 服务器状态。
  • GET /quotes →最后的缓存报价与任何单个标记错误.

API说明

报价来自stooq.pl。某些令牌可能无法使用或数据传播延迟;任何错误都会在字段中报告 errors 的答案。

发展

代码生活在 src/:

  • configLoader.js读取和验证配置文件。
  • stooqClient.js与公共API集成。
  • server.jsMCP HTTP 服务器和刷新调度。

要适应民意调查或市场,只需修改 config/etfs.json 然后重新启动服务器。