🚀 股票单一 MCP（Model Control Protocol）

本项目提供了一个通用的MCP（模型控制协议），可从Angle One API获取股票数据和进行技术分析。该MCP能在任何支持MCP协议的平台（如Cursor、Copilot、Claude AI等）上使用，为股票数据获取和分析提供了便捷的解决方案。

✨ 主要特性

• 📈 获取历史股票数据（可配置时间段）
• 📊 计算技术指标（RSI、EMA - 20、EMA - 50）
• 🌐 RESTful API端点
• 🔓 CORS启用
• 💻 用TypeScript编写
• 🛠️ 通用MCP集成

📦 安装指南

先决条件

• Node.js（v14或更高版本）
• Angle One API凭证
• 任何支持MCP的平台（Cursor、Copilot等）

安装步骤

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

3. 在根目录下创建一个.env文件，并添加您的Angle One凭证：

   ANGLE_ONE_PUBLISHER_API_KEY=your_api_key_here
   ANGLE_ONE_CLIENT_ID=your_client_id_here
   ANGLE_ONE_PIN=your_pin_here
   ANGLE_ONE_TOTP=your_totp_secret_here
   PORT=3000
   DATA_PERIOD_MONTHS=6  # 可选：要获取的历史数据的月份数（默认：6）
   

💻 使用示例

运行服务器

开发模式（带有热重载）

npm run dev

构建并在生产中运行

npm run build
npm start

监视模式（用于开发）

npm run watch

API 端点

获取股票数据和分析

GET /api/stock/:symbol

示例：

GET http://localhost:3000/api/stock/RELIANCE

响应包括：

• 历史数据（OHLCV）
• 技术指标（RSI、EMA - 20、EMA - 50）

📚 详细文档

技术指标

服务器计算以下技术指标：

• RSI（相对强度指数）- 14个周期
• EMA（指数移动平均线）- 20和50个周期

配置

数据周期

您可以配置要获取的历史数据的月份数，方法是设置DATA_PERIOD_MONTHS环境变量。默认值为6个月。 示例：

DATA_PERIOD_MONTHS=12  # 获取1年的数据
DATA_PERIOD_MONTHS=3   # 获取3个月的数据

MCP 集成

此API作为通用MCP可用，可用于任何支持MCP协议的平台。

TypeScript

该项目用TypeScript编写，并包括以下类型的定义：

• API响应
• 技术指标
• 请求/响应对象
• 环境变量