使用说明
监控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 然后重新启动服务器。