Nifty Technical Indicators

Nifty テクニカル指標 MCP サーバー

このプロジェクトは、インド国立証券取引所（NSE）に上場している株式の一般的なテクニカル指標を計算するための Model Context Protocol（MCP）サーバーを提供します。すべての指標の計算に TA-Lib を使用し、stdio トランスポートを使って MCP サーバーとしてローカルで実行できます。

特長

• Yahoo Finance を使用して、任意の NSE ティッカーの過去 1 年分の日次 OHLCV データを取得します
• 主要なテクニカル指標を計算します：
  • SMA50（50 日単純移動平均）
  • MACD（移動平均収束拡散）
  • RSI14（14 日相対力指数）
  • ATR（平均真の値幅）
  • ボリンジャーバンド（20 日）
  • 20 日平均出来高
• 前日の始値、高値、安値、終値、出来高を返します
• 単一の MCP ツール get_technical_indicators を公開します
• すべての指標値を含む、整理された JSON オブジェクトを出力します

要件

• Python 3.8+
• TA-Lib
• yfinance
• mcp（Model Context Protocol サーバー）

インストール

1. リポジトリをクローンします：

   git clone https://github.com/sasikiranaratla/nifty_technical_indicators_mcp.git
   cd nifty_technical_indicators_mcp
   

2. 仮想環境を作成して有効化します：

   python -m venv venv
   venv\Scripts\activate  # On Windows
   source venv/bin/activate  # On Linux/Mac
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

   requirements.txt が見つからない場合は、手動でインストールします：

   pip install pandas TA-Lib yfinance mcp
   

使用方法：MCP サーバーとして実行（stdio）

stdio トランスポートを使用して MCP サーバーをローカルで実行するには：

python main.py

または、仮想環境を使用する場合：

venv\Scripts\python.exe main.py  # On Windows
source venv/bin/activate && python main.py  # On Linux/Mac

これにより MCP サーバーが起動し、get_technical_indicators ツールが公開されます。MCP 対応のクライアントまたはインテグレーションを使用して接続できます。

MCP ツール：get_technical_indicators

• 入力： ticker（str）— NSE の株式シンボル（例："RELIANCE"、"TCS"）
• 出力： 次の項目を含む JSON オブジェクト：
  • SMA50
  • MACD_Line、MACD_Signal、MACD_Hist
  • RSI14
  • ATR
  • BB_Upper、BB_Middle、BB_Lower
  • Vol_Avg20
  • Prev_OHLCV：前日の {Open, High, Low, Close, Volume}

MCP リクエストの例

{
  "tool": "get_technical_indicators",
  "args": {"ticker": "RELIANCE"}
}

MCP レスポンスの例

{
  "SMA50": 2795.12,
  "MACD_Line": 12.34,
  "MACD_Signal": 10.56,
  "MACD_Hist": 1.78,
  "RSI14": 55.67,
  "ATR": 45.12,
  "BB_Upper": 2900.45,
  "BB_Middle": 2750.23,
  "BB_Lower": 2600.01,
  "Vol_Avg20": 1234567.0,
  "Prev_OHLCV": {
    "Open": 2780.0,
    "High": 2800.0,
    "Low": 2770.0,
    "Close": 2795.0,
    "Volume": 1500000.0
  }
}

注意事項

• 信頼性と速度を高めるため、すべての計算に TA-Lib を使用します。
• データは yfinance を介して Yahoo Finance から取得します。
• MCP サーバーは、MCP に対応する任意の LLM または自動化プラットフォームと統合できます。

ライセンス

MIT

作者

sasikiranaratla