stockmatrix-mcp

stockmatrix-mcp

StockMatrix（https://stockmatrix.co.kr）公式 MCP サーバーです。

AI と自然な会話をしながら、韓国株式市場のテーマについて質問できます。200 以上の KOSPI／KOSDAQ 投資テーマを追跡し、日次の値上がり・値下がり銘柄を確認したり、銘柄が属するテーマを調べたり、テーマを並べて比較したり、予測を確認したりできます。すべて Claude、Cursor、または MCP 互換の AI エージェントを通じて利用できます。

TLI（Theme Lifecycle Index） を採用しています。検索への関心、ニュースの勢い、市場のボラティリティ、銘柄の活動状況を組み合わせ、ライフサイクル段階を分類した 0～100 のスコアを算出する、ベイズ最適化されたスコアリングアルゴリズムです。

11 個のツール＋ワンクリックで実行できる 4 つのワークフロープロンプト＋ライブリソース。 韓国市場の概要をすぐに確認するには、market_briefing スラッシュコマンドをお試しください。

クイックスタート

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

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

Cursor / Windsurf

.cursor/mcp.json または .windsurf/mcp.json に追加します。

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

VS Code / Claude Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

質問してみましょう

セットアップ後は、自然な言葉で質問するだけです。

プロンプト	動作
"요즘 뜨는 테마 TOP 5"	TLI スコア順にランキングした上位 5 テーマ
"오늘 한국 테마 시장 요약해줘"	AI 向けに最適化された市場概要
"어제 대비 가장 많이 오른 테마는?"	日次スコアの変動と段階の移行
"AI 관련 테마 찾아줘"	AI 関連テーマを検索
"반도체 vs 2차전지 비교해줘"	テーマを並べて比較
"앞으로 오를 테마 알려줘"	類似事例の根拠付きで、上昇が予測されるテーマを表示
"삼성전자가 속한 테마"	銘柄からテーマを検索（6 桁のコードを自動検出）
"방산 테마 상세 정보"	スコアの内訳、銘柄、ニュース、比較
"반도체 테마 최근 한달 추세"	30 日間のスコア履歴
"TLI 점수는 어떻게 계산돼?"	アルゴリズムの方法論（ヒント：section=scoring を指定するとトークンを節約できます）
"What are the hottest stock themes in Korea?"	英語でも利用できます

利用可能なツール

get_theme_ranking

ライフサイクル段階ごとのテーマランキングを、件数と並べ替えオプションを指定して取得します。

パラメーター	型	必須	説明
stage	string	いいえ	emerging / growth / peak / decline / reigniting
limit	number	いいえ	段階ごとの結果件数（1～50、デフォルト：10）
sort	string	いいえ	score / change7d / newsCount7d（デフォルト：score）

get_market_summary

上位テーマを含む、AI 向けに最適化された市場概要を取得します（連続した呼び出しに使える themeId を含みます）。

get_theme_changes

日次または週次のスコア変動、段階の移行、新たに台頭したテーマを取得します。

パラメーター	型	必須	説明
period	string	いいえ	1d（デフォルト） / 7d

compare_themes

2～5 個のテーマについて、スコア、銘柄、スパークライン、類似度を並べて比較します。

パラメーター	型	必須	説明
theme_ids	string[]	はい	2～5 個のテーマ UUID の配列

get_predictions

過去の類似事例との照合に基づき、上昇、ピーク、または落ち着きが予測されるテーマを取得します。

パラメーター	型	必須	説明
phase	string	いいえ	rising / hot / cooling（デフォルト：すべて）

search_themes

キーワード、銘柄名、または銘柄コードでテーマを検索します。

パラメーター	型	必須	説明
query	string	はい	例："AI"、"반도체"、"삼성전자"、"005930"

search_stocks

会社名または 6 桁のコードで銘柄を検索し、関連テーマのプレビューを表示します。6 桁のコードの場合は、銘柄からテーマを自動的に検索します。

パラメーター	型	必須	説明
query	string	はい	例："삼성전자"、"SK하이닉스"、"005930"

get_stock_themes

逆引き検索 — 銘柄が属するすべてのテーマをテーマスコア順に表示し、それぞれのライフサイクル段階と銘柄との関連度を示します。「保有銘柄は注目テーマに含まれているか？」を確認できます。

パラメーター	型	必須	説明
symbol	string	はい	6 桁の韓国株式コード。例："005930"（Samsung）、"000660"（SK Hynix）

get_theme_detail

スコアの内訳（4 つの要素）、段階、予測、銘柄、ニュース、比較など、詳細な分析を取得します。

パラメーター	型	必須	説明
theme_id	string (UUID)	はい	ランキングまたは検索で取得したテーマの UUID

get_theme_history

トレンド分析用に、過去 30 日間のスコア履歴を取得します。

パラメーター	型	必須	説明
theme_id	string (UUID)	はい	テーマの UUID

get_methodology

スコアリング、段階、安定化、比較、予測、データソースなど、TLI アルゴリズムのドキュメントを取得します。

パラメーター	型	必須	説明
section	string	いいえ	scoring / stages / comparison / prediction / all（デフォルト：all）

Tip：スコアリングアルゴリズムのみを取得してコンテキストトークンを節約するには、section=scoring を使用してください。

ワークフロープロンプト

ワンクリックのスラッシュコマンド（Claude Desktop、Cursor、その他の MCP クライアントで利用可能）を使うと、複数のツールによる分析を一括で実行できます。価値ある情報を最もすばやく得る方法です。

プロンプト	引数	内容
market_briefing	—	韓国市場の本日のテーマブリーフィング：市場のムード、上位テーマ、値動きの大きい銘柄、要点
theme_deep_dive	theme	1 つのテーマのライフサイクルを詳細に分析：スコア、過去 30 日間のトレンド、銘柄、ニュース、見通し
find_investment_themes	interest	関心に合うテーマを見つけ、モメンタムと段階の順に表示
stock_theme_check	stock	銘柄（名称またはコード）が注目テーマまたは上昇中のテーマに含まれているかを確認

リソース

アタッチ可能な読み取り専用コンテキスト（ツール呼び出しは不要）：

URI	説明
stockmatrix://methodology	TLI のスコアとライフサイクル段階の算出方法 — 重みとしきい値
stockmatrix://rankings	本日のテーマランキングをスコア順にまとめ、段階別に分類した最新スナップショット

スコアリングアルゴリズム

TLI スコア（0〜100）は、ベイズ最適化によって最適化された 4 つの要素の加重合計です。

要素	重み	ソース
検索関心度	30.4%	Naver DataLab
ニュースモメンタム	36.6%	Naver News
ボラティリティ	10.4%	関心度の時系列データ
銘柄の取引活動	22.6%	Naver Finance

スコアは、慎重な減衰（3 つのシグナルによる多数決）、ボリンジャーバンドクランプ（日次変動を制限）、経過期間に応じた EMA（新しいテーマほど速く反応）によって安定化されます。

ライフサイクル段階

Dormant -> Emerging -> Growth -> Peak -> Decline -> Dormant
                                          |
                                     Reigniting

段階の遷移には、同じ候補が 2 日連続で続く必要があり（ヒステリシス）、マルコフ遷移の制約に従います。

データカバレッジ

• 200 以上のテーマ（KOSPI および KOSDAQ）
• 毎日更新 — スコア、ニュース、銘柄とのマッピング
• 銘柄 ↔ テーマの検索 — 企業名、6 桁のコード、または逆引き（銘柄 → 関連するすべてのテーマ）
• AI 市場サマリー（初回呼び出し時の概要）
• 過去の類似事例との照合による予測
• ワークフロープロンプト — ワンクリックで複数ツールによる分析を実行
• ソース：Naver DataLab、Naver Finance、Naver News

設定

変数	デフォルト	説明
STOCKMATRIX_API_URL	https://stockmatrix.co.kr	API のベース URL を上書きします

ライセンス

MIT

リンク

• ウェブサイト
• 開発者ガイド
• llms.txt