stock-scanner-mcp

stock-scanner-mcp

Claude Code と Claude Desktop 向けのモジュール型 MCP サーバーで、株式および暗号資産の市場データにリアルタイムでアクセスできます。1つのサーバーから市場をスキャンし、テクニカル指標を確認し、インサイダー取引を監視し、決算を追跡し、オプション取引のフローを分析できます。また、任意で自分のウォッチリストや投資仮説のメモを保存できます。

15モジュールにまたがる69個のツールを備えています。API キーなしで利用できるモジュールは11個あり、オプションのステートフルな Market Workspace も含まれます。

クイックスタート

すべての機能を利用するための3つの手順は、サーバーの設定、トレーディングスキルの導入、ワークスペースの設定です。

手順1 — MCP 設定にサーバーを追加する

以下の設定ブロック全体を設定ファイルにコピーします。

• Claude Code： ~/.claude.json（グローバル）または .mcp.json（プロジェクトローカル）
• Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）

{
  "mcpServers": {
    "stock-scanner": {
      "command": "npx",
      "args": ["-y", "stock-scanner-mcp", "--enable-workspace"],
      "env": {
        "FINNHUB_API_KEY": "your-key-here",
        "ALPHA_VANTAGE_API_KEY": "your-key-here",
        "FRED_API_KEY": "your-key-here"
      }
    }
  }
}

これにより、API キーなしですぐに49個のツールを利用できます。API キーは任意で、無料です。設定すると、リアルタイムの株価、ニュース、決算、経済データを扱う20個のツールが追加で利用できます。入手先については、以下のAPI キー（任意）を参照してください。

最小限の設定 — ワークスペースや API キーが不要な場合は、代わりにこちらを使用してください。

{
  "mcpServers": {
    "stock-scanner": {
      "command": "npx",
      "args": ["-y", "stock-scanner-mcp"]
    }
  }
}

ローカルにデータを保存せず、42個のステートレスなツールを利用できます。

保存後に Claude Desktop を再起動してください。Claude Code は設定を自動的に読み込みます。

Claude Code のショートカット — 手順1と2の代わりにプラグインとしてインストールする。 Claude Code をお使いの場合は、上記の手動設定を省略し、次の2つのコマンドですべてをインストールできます。

/plugin marketplace add yyordanov-tradu/stock-scanner-mcp
/plugin install stock-scanner@tradu-marketplace

/reload-plugins を実行してから /mcp を実行すると、stock-scanner サーバーが接続済みとして表示されます。初回起動時に npx -y stock-scanner-mcp が実行され、パッケージが一度ダウンロードされます（以後はキャッシュされます）。プラグインではワークスペースがデフォルトで有効になり（データは ~/.stock-scanner-mcp に保存されます）、任意の API キー（FINNHUB_API_KEY、ALPHA_VANTAGE_API_KEY、FRED_API_KEY）は環境変数から引き継がれます。キーがないモジュールは自動的にスキップされます。

プラグインにはスキルがすでに含まれているため、手順2は実行しないでください。 19個すべてのスキルはプラグインに含まれており、stock-scanner: 名前空間の下で読み込まれます（例：/stock-scanner:analyze-stock AAPL、/stock-scanner:morning-briefing、/stock-scanner:setup-market-workspace）。手順2のインストーラーも実行すると、名前空間のない2つ目のセットが ~/.claude/skills/ にコピーされ、両者が競合します。手順2は手動（プラグインを使わない）インストールの場合にのみ実行してください。インストール後は、名前空間付きのコマンド /stock-scanner:setup-market-workspace を使って、手順3に進んでください。

手順2 — トレーディングスキルをインストールする

上記のプラグインからインストールした場合は、この手順を省略してください。プラグインにはこれらのスキルがすでに含まれています（stock-scanner:<name>）。この手順は、手順1で手動設定した場合にのみ必要です。

ターミナルで次のコマンドを実行します。

npx -p stock-scanner-mcp stock-scanner-install-skills

これにより、19個のスラッシュコマンド（/morning-briefing、/analyze-stock AAPL、/setup-market-workspace など）が ~/.claude/skills/ にインストールされ、すべての Claude Code セッションで利用できるようになります。全コマンドについては、トレーディングスキルを参照してください。

ステップ 3 — ワークスペースを設定する

Claude Code で /setup-market-workspace を実行します。次の簡単な質問が 3 つ表示されます。

> /setup-market-workspace

Setting up your market workspace — I'll ask a few quick questions to get started...

1. What kind of trader or investor are you?
   (e.g., options trader, swing trader, long-term investor, crypto-focused)

   → "I'm mostly a swing trader, also watch crypto"

2. Which names or assets should I save to your core watchlist?
   (e.g., AAPL, MARA, BTC, Gold)

   → "MARA, HOOD, SOFI, BTC, ETH"

3. Do you want a daily or weekly market review?

   → "Daily"

回答すると、プロフィールが保存され、core ウォッチリストが作成されます。

✓ Workspace saved

  Profile     swing trader | daily review
  Watchlist   core — MARA, HOOD, SOFI, BTC, ETH

スキルを使わず、Claude に直接依頼することもできます。「ワークスペースを設定してください。スイングトレーダーです。MARA、HOOD、BTC を含む core ウォッチリストを作成し、毎日レビューしてください。」

これで完了です。 69 個のツール、19 個のスキル、そしてパーソナライズされたワークスペースが利用できるようになりました。最初のカスタマイズされたマーケットスキャンを試すには、/workspace-morning-brief を実行してください。

できること

"What are the top gaining stocks today?"
"Show me technicals for AAPL on the hourly timeframe"
"Any insider trades for TSLA in the last 30 days?"
"What's the options chain for AAPL expiring next Friday?"
"What's the current fed funds rate and CPI trend?"
"Convert $10,000 USD to EUR"
"Set up a core watchlist with MARA, HOOD, and BTC"
"Give me a personalized morning brief for my saved watchlist"

主な機能

• 株式スキャン — カスタムフィルターを使って、価格、RSI、出来高、時価総額でスクリーニングします
• テクニカル分析 — 複数の時間足で RSI、MACD、ボリンジャーバンド、移動平均線、ピボットを分析します
• オプションフロー — ギリシャ指標付きのチェーン、異常な取引の検出、最大ペイン、予想変動幅を確認できます
• インサイダー取引 — 売買や付与の詳細を含む Form 4 取引を解析します
• 決算とニュース — カレンダー、アナリスト評価、企業ニュース、空売り残高を確認できます
• 暗号資産 — リアルタイムの相場、テクニカル指標、トレンドのコイン、市場統計を確認できます
• マクロ経済 — CPI、GDP、FF 金利、経済カレンダー、イールドカーブのデータを確認できます
• 外国為替 — ECB の 31 通貨ペア、通貨換算、過去の為替レートを確認できます
• センチメント — CNN Fear & Greed Index、Crypto Fear & Greed を確認できます
• Market Workspace — 取引プロフィール、名前付きウォッチリスト、銘柄ごとの投資仮説メモを保存し、セッションをまたいでパーソナライズされたワークフローを利用できます

トレーディングスキル

複数のツールを連携して構造化された分析を行う、すぐに使えるワークフローが 19 種類あります。各スキルは 5～14 個のツールを並行して実行し、方向性、確信度、重要な価格水準を含む判断結果を出力します。

オプションの API キーが設定されていない場合も、スキルは可能な範囲で動作します。ワークスペーススキルを使うには、サーバー設定で --enable-workspace を指定する必要があります。

npx -p stock-scanner-mcp stock-scanner-install-skills                    # all 19 skills
npx -p stock-scanner-mcp stock-scanner-install-skills --scope project    # project only (.claude/skills/)
npx -p stock-scanner-mcp stock-scanner-install-skills --category macro   # one category
npx -p stock-scanner-mcp stock-scanner-install-skills --category workspace # workspace skills only
npx -p stock-scanner-mcp stock-scanner-install-skills --list             # list without installing
npx -p stock-scanner-mcp stock-scanner-install-skills --force            # overwrite existing

全スキルの一覧は skills/README.md をご覧ください。

Market Workspace

Market Workspace は、セッションをまたいで取引に関するコンテキストを記憶する、任意のステートフルレイヤーです。取引スタイル、名前付きウォッチリスト、銘柄ごとの投資仮説メモを記憶します。/workspace-morning-brief などのスキルはこのコンテキストを使い、一般的なスキャンではなく、パーソナライズされたマーケットスキャンを提供します。

利用できる機能

• /workspace-morning-brief — プロフィールとウォッチリストを読み込み、登録銘柄の決算、ニュース、値動きを確認して、その日に重要な情報を強調する、パーソナライズされた市場開始前のスキャンです
• ウォッチリストを追加する — Claude に次のように依頼します。「AAPL、MSFT、GOOG を含む『earnings』という名前のウォッチリストを作成してください」
• 投資仮説を追跡する — システムがモニタリングできるよう、銘柄ごとの投資判断の根拠を保存します（下記を参照）
• いつでも更新する — 「NVDA を core ウォッチリストに追加してください」、または 「レビュー頻度を毎週に変更してください」

Thesis Tracking

ティッカーごとに投資判断の根拠を保存します。方向性、重要な価格水準、材料、時間軸を記録することで、セッションをまたいでシステムが追跡できます。

投資判断の根拠を保存する：

"My thesis on NIO: bullish above $6.35, that confirms the uptrend. Below it the setup is invalid."

Claude は構造化された投資判断の根拠を保存します。

実際の動作： /workspace-morning-brief を実行すると、ブリーフは保存した投資判断の根拠とリアルタイムの値動きを照合します。

• NIO が 6.10 ドルまで下落 → 「NIO が投資判断の下限である 6.35 ドルを下回りました。再評価してください。」
• NIO が 7.20 ドルまで上昇 → 「NIO は 6.35 ドルの水準を上回って推移しています。上昇トレンドの見立ては維持されています。」

投資判断の根拠がなければ、ブリーフは価格変動を報告するだけです。投資判断の根拠があれば、その値動きが投資計画にとって重要かどうかを伝えます。

各投資判断の根拠には、summary、bullCase、bearCase、catalyst、timeframe の 5 つのフィールドがあります。ワークスペースごとに最大 200 件まで保存できます。

設定リファレンス

データはローカルの workspace.json に保存されます。クラウド同期や外部への呼び出しはありません。--enable-workspace を省略すると、サーバーは完全にステートレスなままで、ローカルデータも書き込みません。

ワークスペースツールの全一覧については、以下のツールリファレンスをご覧ください。

ドキュメント

• インストールとセットアップ — Claude Code または Cursor で MCP サーバーを起動する方法
• トレーディングスキル — プロフェッショナルな分析に使える、すぐに利用可能なワークフロー
• サイドカー HTTP API — MCP クライアント以外でも利用できる REST エンドポイント
• Docker デプロイ — ワークスペースの永続化に対応したコンテナでの実行
• よくある質問とトラブルシューティング — よくある問題と解決方法

モジュール

API キーを設定すると、該当するモジュールが自動的に有効になります。API キー不要のモジュールは常に有効ですが、workspace には --enable-workspace が必要です。

説明付きの全ツール一覧については、以下のツール完全リファレンスをご覧ください。

ツール完全リファレンス（69個のツール）

TradingView — 株式スキャン（API キー不要）

TradingView — 暗号資産（API キー不要）

SEC EDGAR — 提出書類と所有権（API キー不要）

CoinGecko — 暗号資産インテリジェンス（API キー不要）

オプション — チェーン、グリークス、異常な取引活動（API キー不要）

Options CBOE — プット／コールのセンチメント（API キー不要）

センチメント — 恐怖と強欲（API キー不要）

Frankfurter — 外国為替レート（API キー不要）

Reddit — トレンドのティッカーとセンチメント（API キー不要）

マーケット・ブレッドス — ブレッドス指標（API キー不要）

統合マーケット — スマートルーティング（API キー不要）

Workspace — パーソナライズされたコンテキスト（任意、API キー不要）

--enable-workspace を指定してサーバーを起動した場合のみ有効です。

Finnhub — ニュース、決算、マクロ経済情報（FINNHUB_API_KEY が必要）

Alpha Vantage — ファンダメンタルズと履歴（ALPHA_VANTAGE_API_KEY が必要）

FRED — 米国の経済データ（FRED_API_KEY が必要）

設定

CLI オプション

npx -y stock-scanner-mcp --modules tradingview,sec-edgar    # Enable specific modules only
npx -y stock-scanner-mcp --default-exchange NYSE             # Set default exchange
npx -y stock-scanner-mcp --enable-workspace                  # Turn on local workspace tools
npx -y stock-scanner-mcp --enable-workspace --data-dir /tmp/market-workspace  # Custom data directory
npx -y stock-scanner-mcp --help                              # Show all options

API キー（任意）

3 つのキーはすべて無料で、クレジットカードは不要です。

MCP 設定の env ブロックに追加してください（クイックスタートを参照）。

他の MCP クライアントでの使用

stdio サーバーに対応した MCP クライアントであれば、このパッケージを実行できます。クイックスタートに記載されているものと同じ JSON 設定を使用してください。クライアントから npx を呼び出せない場合は、先にパッケージをインストールして、インストール済みのバイナリをクライアントに指定してください。

HTTP サイドカー

すべてのツールを REST エンドポイントとして公開するオプションの HTTP サーバーです。MCP を使用しない連携（GPT Actions、チャット UI、LLM パイプライン）向けに利用できます。自動的にツールを検出するための OpenAPI 3.1 仕様が含まれています。

npx stock-scanner-sidecar              # Start on port 3200
npx stock-scanner-sidecar --port 8080  # Custom port

# Optional: Enable the stateful Market Workspace via HTTP
npx stock-scanner-sidecar --enable-workspace --data-dir ./my-data

# Access the OpenAPI spec
curl http://localhost:3200/openapi.json

エンドポイントの詳細については、サイドカー HTTP API をご覧ください。

/market/quote、/options/chain、/workspace/profile などを含む 69 個のツールが REST ルートとして公開されています。

レート制限

すべてのモジュールでメモリ内 TTL キャッシュを使用し、API 呼び出しを最小限に抑えています。

開発

npm install && npm run build && npm test
npm run lint               # TypeScript type checking
npm run validate-tools     # Tool description quality check
npm run validate-doc-tools # Skill/command tool reference check

信頼性を示す資料

• ベンチマーク例
• 会話のサンプル
• レイテンシと信頼性の概要

src/
├── index.ts              # MCP server entry + prompt definitions
├── config.ts             # CLI arg parsing
├── registry.ts           # Module auto-discovery and filtering
├── modules/
│   ├── tradingview/      # 10 tools — stock scanning, quotes, technicals, sectors, indices
│   ├── tradingview-crypto/ # 4 tools — crypto scanning and technicals
│   ├── sec-edgar/        # 6 tools — filings, insider trades, holdings
│   ├── coingecko/        # 3 tools — crypto market data
│   ├── options/          # 5 tools — options chains, Greeks, unusual activity, implied move
│   ├── options-cboe/     # 1 tool  — CBOE put/call ratio sentiment
│   ├── workspace/        # 7 tools — stateful profile, watchlists, thesis notes
│   ├── finnhub/          # 9 tools — quotes, news, earnings, analyst ratings, short interest
│   ├── alpha-vantage/    # 5 tools — quotes, fundamentals, dividends
│   ├── fred/             # 4 tools — economic calendar, indicators, historical data
│   ├── sentiment/        # 2 tools — Fear & Greed indexes (market + crypto)
│   ├── frankfurter/      # 5 tools — forex exchange rates (ECB, 31 currencies)
│   ├── reddit/           # 4 tools — trending tickers, mentions, sentiment, watchlist scan from Reddit
│   └── unified-market/   # 3 tools — smart provider routing for quotes/profiles/technicals
├── sidecar/
│   ├── index.ts          # HTTP sidecar entry point (port 3200)
│   ├── routes.ts         # Declarative URL routing table
│   └── server.ts         # Dynamic HTTP request handler
└── shared/
    ├── http.ts           # HTTP client with timeouts and key sanitization
    ├── cache.ts          # In-memory TTL cache
    ├── types.ts          # ToolDefinition, ToolResult, helpers
    ├── resolver.ts       # Ticker/exchange resolution
    └── utils.ts          # withMetadata error wrapper

ライセンス

MIT