Indian Stock Exchange

Indian Stock Exchange MCP Server

Claude（および任意の MCP クライアント）に、NSE/BSE の株式、ファンダメンタルズ、アナリスト目標株価、IPO、投資信託、コモディティへのリアルタイムアクセスを提供する MCP サーバーです。次のような質問ができます。

• 「TCS、Infosys、Wipro のバリュエーション、利益率、モメンタムを比較してください。」
• 「Reliance の財務、株主構成の変化、アナリスト目標株価、最近の提出書類を含む調査メモを作成してください。」
• 「今日は何が市場を動かしていますか？今週、公開が始まる IPO はありますか？」
• 「過去 3 年間のリターンで優れた中型株投資信託を絞り込み、上位 3 本を比較してください。」

データは Indian Stock Market API から取得されます。

compare-stocks ツールの実際の出力です。node scripts/capture-demo.mjs && scripts/render-demo.sh を実行すると再生成できます。

機能

• 27 個のツール。すべて読み取り専用として注釈されており、生の API ダンプではなく、簡潔で分析に適した出力を返します
• 1 回の呼び出しで株式スナップショットを取得：価格、価格レンジ、バリュエーション、収益性、成長性、レバレッジ、リターン、移動平均のトレンド、アナリストのコンセンサス、同業他社
• ファンダメンタルズ：複数年の損益計算書、貸借対照表、キャッシュフロー、各種比率、株主構成、アナリスト予想、目標株価
• 市場情報：値上がり・値下がり銘柄、売買高上位銘柄、急変銘柄、52 週高値・安値、ニュース、IPO カレンダー、コモディティ先物
• 投資信託：検索、カテゴリーやリターン別の閲覧、各スキームの詳細
• 5 個のプロンプト（analyze-stock、compare-stocks、market-briefing、dividend-and-events、mutual-fund-picks）と 3 個のリソース（ニュース、IPO カレンダー、ise://stock/{name}）
• 信頼性の高いクライアント：リクエストのタイムアウト、429/5xx エラー時のバックオフ付き再試行、メモリ内 TTL キャッシュ、実行中リクエストの重複排除、明確なエラーメッセージを備え、API キーが出力に表示されることはありません
• デスクトップクライアント向けの stdio トランスポートと、リモート利用向けのステートレスな Streamable HTTP

ツール

分野	ツール	機能
株式	search-stocks	銘柄名から NSE/BSE コードと ISIN を特定します
	get-stock-snapshot	銘柄の概要を簡潔に表示します（まずはこちらをお試しください）
	get-stock-price	最新価格、日中レンジ、52 週レンジを取得します
	get-stock-details	プロフィール、主要指標、株主構成、アクション、セクション別ニュースを取得します
	get-stock-history	1 か月から全期間までの価格、P/E、P/B、利益率、EV の履歴を取得します
	compare-stocks	2～5 銘柄を並べて比較します
	get-peers	バリュエーションとリターンを含む同業他社を取得します
	get-stock-recommendations	アナリスト評価の内訳と推移を取得します
ファンダメンタルズ	get-financial-statements	四半期・年間業績、貸借対照表、キャッシュフロー、各種比率を取得します
	get-shareholding-pattern	プロモーター、FII、DII、一般株主の保有状況を時系列で取得します
	get-analyst-estimates	コンセンサス予想または実績を取得します（EPS、売上高、純利益、EBITDA、ROE など）
	get-price-target	平均・最高・最低目標株価とコンセンサス評価を取得します
	get-corporate-actions	配当、ボーナス、株式分割、新株引受権、取締役会の開催を取得します
	get-announcements	リンク付きの最近の取引所提出書類を取得します
市場	get-market-overview	値動き、取引状況、急変銘柄、主要ニュースを 1 回の呼び出しで取得します
	get-top-gainers / get-top-losers	本日の値上がり・値下がり上位銘柄を取得します
	get-most-active	取引高上位の銘柄を取得します（NSE または BSE）
	get-price-shockers	通常と異なる価格変動を示す銘柄を取得します（NSE または BSE）
	get-52-week-highs-lows	52 週の高値・安値に達した銘柄を取得します
	get-news / get-market-news	要約付きの最新ニュースを取得します
	get-ipos	今後の IPO、申込受付中の IPO、終了済み IPO、上場済み IPO を取得します
	get-commodities	建玉のシグナル付きで MCX 先物を取得します
投資信託	search-mutual-funds	名前からスキームを検索します
	get-mutual-fund-details	NAV、リターン、リスク、経費率、保有銘柄を取得します
	list-mutual-funds	カテゴリーやリターン期間で閲覧・ランキング表示します

セットアップ

Node.js 20+ と indianapi.in の API キーが必要です。

git clone <this repo> && cd Indian-Stock-Exchange-MCP
cp .env.example .env        # then set ISE_API_KEY
npm install
npm run build

キーは ISE_API_KEY 環境変数、.env、または src/.env から読み込まれます。キーをコミットしないでください。これら3つのファイルはすべて Git の除外対象です。

Claude Desktop

Settings > Developer > Edit Config：

{
  "mcpServers": {
    "indian-stock-exchange": {
      "command": "node",
      "args": ["/absolute/path/to/Indian-Stock-Exchange-MCP/build/index.js"],
      "env": { "ISE_API_KEY": "your_api_key_here" }
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add indian-stock-exchange --env ISE_API_KEY=your_api_key_here -- node /absolute/path/to/build/index.js

HTTP モード

npm run start:http          # http://127.0.0.1:3000/mcp  (health check: /health)

ステートレスな Streamable HTTP で、デフォルトでは localhost にバインドされます（HOST と PORT で上書きできます）。認証機能がないため、お使いのマシンの外部に公開する前に、認証機能付きのリバースプロキシの背後に配置してください。

開発

npm test         # build + unit tests (mocked HTTP, no key needed)
npm run smoke    # calls every tool against the live API (needs ISE_API_KEY)

src/
  index.ts          entry point: stdio or --http
  server.ts         builds the McpServer and registers everything
  client.ts         API client: auth, timeout, retry, cache
  tools/            stocks, fundamentals, market, funds
  prompts.ts        reusable analysis prompts
  resources.ts      news, IPO and per-stock resources

注意事項

• 金額の単位は INR、市場時価総額の単位は crore です。
• get-top-gainers／get-top-losers は API のトレンドリストに基づいており、BSE 上場銘柄が対象です。NSE の銘柄には exchange: NSE を指定して get-price-shockers を使用してください。
• レスポンスはデフォルトで60秒間キャッシュされます（ISE_CACHE_TTL_MS）。履歴とファンダメンタルズは、より長くキャッシュされます。
• このサーバーは情報を提供するものであり、投資助言ではありません。

ライセンス

MIT