Angle One MCP Server

🚀 股票單一 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響應
• 技術指標
• 請求/響應對象
• 環境變量