Indian NSE Stock Insights

インド NSE 株価インサイト 🇮🇳📈

インド株式市場分析のための公開 MCP サーバー — Nifty 500 の銘柄群、12 個のツール、3 つの時間足。

FastMCP で構築 · データ提供元は yfinance · ホスト先は stockmcp.alokbarnwal.com

教育目的のみです。投資助言ではありません。 DISCLAIMER.md をご覧ください。

クイック接続 — 30 秒

Claude.ai → 設定 → コネクタ → カスタム MCP コネクタを追加：

Name: Indian NSE Stock Insights
URL:  https://stockmcp.alokbarnwal.com/mcp

これで完了です。インド株について質問してみましょう。

12 個のツール

timeframe のデフォルトは daily です。選択肢：daily、15min、5min。

プロンプトの例

接続後、Claude.ai で次のように試してみましょう：

• 「RELIANCE のテクニカル分析をして — RSI、MACD、サポート／レジスタンス水準を教えて」
• 「RSI が 30 未満で ADX が 25 を超える Nifty 500 の銘柄を表示して」
• 「TCS、INFY、WIPRO を比較して — 現時点で最も有望な銘柄はどれ？」
• 「今日の市場全体の状況は？上昇率上位と下位の銘柄を表示して」
• 「15 分足チャートで HDFC Bank の需要ゾーンと供給ゾーンを表示して」

アーキテクチャ

graph TB
    subgraph Internet
        C[Claude.ai / MCP Client]
    end

    subgraph Server["Production Server"]
        subgraph Protection
            F2B[fail2ban<br/>auto-ban repeat abusers]
            NG[nginx<br/>rate limit 20r/s · conn limit · TLS]
        end

        subgraph Application
            MCP["FastMCP Server<br/>port 8089 · 12 tools"]
            TOOLS["Tool Modules<br/>quote · ohlc · indicators<br/>levels · zones · patterns<br/>fibonacci · volume · market<br/>compare · screener"]
        end

        subgraph Data
            DB[(MySQL: nse_public<br/>500 stocks × 3 timeframes)]
            CRON[Cron Jobs<br/>5min · 15min · daily]
        end
    end

    subgraph External
        YF[Yahoo Finance<br/>yfinance API]
    end

    C -->|HTTPS POST /mcp| NG
    NG -->|proxy_pass| MCP
    MCP --> TOOLS
    TOOLS -->|read-only queries| DB
    YF -->|OHLCV data| CRON
    CRON -->|upsert| DB
    F2B -.->|monitors| NG

データのカバレッジ

取引時間：月曜日～金曜日の 09:15～15:30 IST（NSE の休場日を除く）。

レート制限

セルフホスト

cd /home/ubuntu
git clone https://github.com/alokbarnwal/nse-public-mcp.git
cd nse-public-mcp

sudo mysql <<'SQL'
CREATE DATABASE IF NOT EXISTS nse_public CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS 'nse_writer'@'localhost' IDENTIFIED BY 'CHANGE_ME_STRONG_PASSWORD';
GRANT ALL PRIVILEGES ON nse_public.* TO 'nse_writer'@'localhost';
FLUSH PRIVILEGES;
SQL

mysql -u nse_writer -p nse_public < db/schema.sql
mysql -u nse_writer -p nse_public < db/schema_indicators.sql
mysql -u nse_writer -p nse_public < db/schema_price_action.sql

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
chmod 600 .env
nano .env                 # set DB_PASSWORD to match step 2

python -m config.stocks --refresh        # fetches NSE archives, rewrites config/stocks.py

python -m config.stocks --load-to-db

screen -S backfill
source .venv/bin/activate
python -m data.backfill --all
# Ctrl-A D to detach. Reattach: screen -r backfill

python -m data.backfill --timeframe 15min --resume

ローソク足のバックフィルが完了したら、全 3 つの時間軸における全 500 銘柄の indicators テーブルを作成します。

screen -S indicators
cd /home/ubuntu/nse-public-mcp
python3 -m indicators.runner --all
# Ctrl-A D to detach

想定実行時間：約 30～45 分です。冪等性があるため、中断した場合も安全に再実行できます。

8c. プライスアクションの一括計算（長時間実行、screen/tmux を使用）

インジケーターの作成が完了したら、全 3 つの時間軸における全 500 銘柄のプライスアクション機能（ゾーン、S/R、パターン、ブレイクアウト、フィボナッチ、ギャップ、出来高プロファイル）を計算します。

screen -S price_action
cd /home/ubuntu/nse-public-mcp
python3 -m price_action.runner --timeframe daily --all-features
python3 -m price_action.runner --timeframe 15min --all-features
python3 -m price_action.runner --timeframe 5min  --all-features
# Ctrl-A D to detach

想定総実行時間：約 60～90 分です。冪等性があるため、中断した場合も安全に再実行できます。

9. crontab のインストール

crontab -e

以下を追加します。

# nse-public-mcp candle updaters
*/5  9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /home/ubuntu/nse-public-mcp/.venv/bin/python -m jobs.cron_5min  >> logs/cron_5min.log 2>&1
*/15 9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /home/ubuntu/nse-public-mcp/.venv/bin/python -m jobs.cron_15min >> logs/cron_15min.log 2>&1
0    18   * * 1-5 cd /home/ubuntu/nse-public-mcp && /home/ubuntu/nse-public-mcp/.venv/bin/python -m jobs.cron_daily >> logs/cron_daily.log 2>&1

# nse-public-mcp indicator updaters (each runs after the matching candle fetch)
30       18   * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_indicators_daily >> logs/indicators_daily.log 2>&1
20,35,50 9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_indicators_15min >> logs/indicators_15min.log 2>&1
5        16   * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_indicators_15min >> logs/indicators_15min.log 2>&1
2-57/5   9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_indicators_5min  >> logs/indicators_5min.log 2>&1

# nse-public-mcp price-action updaters (each runs after the matching indicator cron)
35       18   * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_price_action_daily  >> logs/price_action_daily.log 2>&1
25,55    9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_price_action_15min >> logs/price_action_15min.log 2>&1
9-54/15  9-15 * * 1-5 cd /home/ubuntu/nse-public-mcp && /usr/bin/python3 -m jobs.cron_price_action_5min  >> logs/price_action_5min.log 2>&1

cron の時刻はサーバーのローカル時刻です。サーバーが IST に設定されていることを確認してください（timedatectl）。設定されていない場合は、時間帯を調整してください。 5 分ごとのインジケーター cron は 2-57/5 にずらしているため、cron_5min の約 2 分後に実行され、古いローソク足を読み込むことはありません。 5 分ごとのプライスアクション cron は 9-54/15（9、24、39、54 分）にずらしているため、各 cron_indicators_5min の実行枠の約 2 分後に実行されます。

10. 検証

mysql -u nse_writer -p nse_public <<'SQL'
SELECT 'daily' AS tf, COUNT(*) AS n FROM candles_daily
UNION ALL SELECT '15min', COUNT(*) FROM candles_15min
UNION ALL SELECT '5min',  COUNT(*) FROM candles_5min;

-- Per-stock coverage on daily — flag any with < 1000 rows (~4 trading years)
SELECT symbol, COUNT(*) AS n
FROM candles_daily
GROUP BY symbol
HAVING n < 1000
ORDER BY n;

-- Latest data freshness
SELECT MIN(candle_date) AS earliest, MAX(candle_date) AS latest
FROM candles_daily;

-- Recent cron health
SELECT job_type, timeframe, symbols_success, symbols_failed, started_at, duration_seconds
FROM fetch_log
ORDER BY started_at DESC
LIMIT 20;
SQL

ディスク上の DB サイズ：

sudo du -sh /var/lib/mysql/nse_public/

サービス管理

# Server status
sudo systemctl status nse-public-mcp

# Restart
sudo systemctl restart nse-public-mcp

# Logs
sudo journalctl -u nse-public-mcp -n 100 -f

# nginx
sudo nginx -t && sudo systemctl reload nginx

# fail2ban
sudo fail2ban-client status nginx-mcp-ratelimit

ディレクトリ構成

アーキテクチャとデータフロー図については、PROJECT.md を参照してください。

config/        # settings, stock universe, holiday calendar
data/          # yfinance fetcher, backfill CLI, shared upsert helpers
db/            # schema and pooled connection
indicators/    # technical indicator compute, persist, runner
price_action/  # zones, patterns, levels, trends
mcp_server/    # FastMCP server + 12 tool modules
jobs/          # cron entrypoints (candles + indicators + price action)
deploy/        # systemd service, nginx config, fail2ban rules
tests/         # mocked unit tests (82 tests)

運用上の注意

• Yahoo Finance に配慮してください。 フェッチャーはリクエスト間に 1～3 秒待機し、バックオフを伴う再試行を行います。これらの設定を短縮しないでください。
• 冪等性があります。 すべての挿入処理は INSERT … ON DUPLICATE KEY UPDATE です。cron の実行を再生したり、バックフィルを再実行したりしても安全です。
• 休場日カレンダーは config/holidays.py にあります。NSE が翌年の一覧を公開したら、年に一度更新してください。
• 保持データのクリーンアップは jobs/cron_daily.py の最後に実行されます。5 年を超える日足、2 年を超える 15 分足、6 か月を超える 5 分足は削除されます。

ライセンス

MIT — 無料で使用、変更、配布できます。

免責事項

このプロジェクトは教育および情報提供のみを目的としています。投資助言ではありません。DISCLAIMER.md を参照してください。