Angle One MCP Server

🚀 株式単一MCP（Model Control Protocol）

このプロジェクトは、Angle One APIから株式データと技術分析を取得するための汎用的なMCP（モデル制御プロトコル）です。この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レスポンス
• 技術指標
• リクエスト/レスポンスオブジェクト
• 環境変数