k-data-mcp

k-data-mcp

韓国株式の調査と市場データを提供する MCP サーバーです。x402 を通じて、呼び出しごとに USDC で課金されます。ウォレットを設定せずに起動して、カタログを確認したり、日付付きの無料プレビューを利用したりできます。有料の呼び出しを利用する場合にのみ、専用ウォレットを追加してください。

ウォレットに入金する前に試す

環境変数を設定せずに npx k-data-mcp を実行すると、次の無料ツールを利用できます。

• list_endpoints — 有料カタログと料金。
• preview_research_coverage — ティッカーごとの実際のレポート件数・証券会社数と、アーカイブの日付範囲。
• preview_research — 1 銘柄の実際のアーカイブの深さ。レポートの内容は開示されません。
• preview_kimchi_premium — BTC のみを対象とする、リアルタイムの二重基準サンプル。

有料ツールを有効にする準備ができたら、K_DATA_PRIVATE_KEY と K_DATA_MAX_SPEND_USD を設定してください。

利用できるデータ

• 取引可能な基準でのキムチプレミアム。 どこも公式 USD/KRW レートに対するプレミアムを公表していますが、韓国の資本規制により、実際の KRW の出口取引は USDT 経由となるため、この数値は取引に利用できません。このツールは両方の数値を返し、符号が異なることも珍しくありません。公式基準では −0.27% と表示される一方、実現可能な基準では +0.19% となることがあります。
• プレミアムの履歴とパーセンタイルの情報。 継続的に記録されたアーカイブにより、「今のプレミアムは異常な水準か？」という疑問に答えられます。1 時間から 90 日までのパーセンタイル、平均、標準偏差、Z スコアを確認できます。このデータを公開する無料ソースはなく、事後に再構成することもできません。
• 英語に翻訳された韓国語のヘッドライン（Yonhap、Maeil Business、Hankyung）。韓国語の大きな数値単位（억 / 조）は翻訳前に決定論的に展開されるため、「989억달러」は、言語モデルが単独で生成する 10 倍ずれた回答ではなく、989 億ドルとして返されます。
• 構造化データとしての韓国のセルサイド調査。 KRX の銘柄ごとの目標株価、レーティング、証券会社、アナリストを英語の要約とともに提供し、そこから作成したコンセンサスと改定履歴も確認できます。どの証券会社が引き上げ、どこが引き下げたのか、各社の見解に実際どの程度の差があるのかが分かります。販売するのは各レポートの事実情報のみで、独自の表現で提供し、発行元へのリンクを付けています。レポートの PDF は作成元の証券会社が保有します。掲載元のデータは直近の期間のみを対象としているため、この時系列も事後に再構成することはできません。
• Upbit の KRW 建てレートと市場サマリー、USD/KRW。

インストール

npx k-data-mcp

Claude Desktop / Claude Code

{
  "mcpServers": {
    "k-data": {
      "command": "npx",
      "args": ["-y", "k-data-mcp"],
      "env": {
        "K_DATA_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "K_DATA_MAX_SPEND_USD": "1"
      }
    }
  }
}

ウォレットの設定

各ツールの呼び出しでは実際の USDC を消費するため、キーと予算が設定されていない場合、サーバーは起動しません。

1. 専用のウォレットを作成してください。メインのウォレットは使わないでください。キーは設定ファイルに保存され、呼び出しごとにそこから支出されます。
2. Base 上で支払ってもよい金額の USDC を入金してください。ETH は不要です。x402 はオフチェーンの EIP-3009 署名で決済し、ガス代はファシリテーターが負担します。
3. K_DATA_MAX_SPEND_USD を設定してください。累積支出がこの上限を超える呼び出しは、サーバーが拒否します。

変数	必須	デフォルト	意味
K_DATA_PRIVATE_KEY	はい	—	支払いウォレットの秘密鍵（Base 上の USDC）
K_DATA_MAX_SPEND_USD	いいえ	1	セッション中の累積支出の上限
K_DATA_BASE_URL	いいえ	ホステッドサービス	別の K-Data デプロイ先を指定

ツール

list_endpoints は無料です。まず呼び出して現在の価格を確認し、購入する価値があるものを判断してください。

ツール	価格	戻り値
list_endpoints	無料	カタログ、現在の価格、ウォレットアドレス、残りの予算
kimchi_premium	$0.03	最大10銘柄のキムチプレミアム（公式価格とUSDT価格）
kimchi_premium_stats	$0.12	1時間～90日間のプレミアムのパーセンタイル、平均、標準偏差、zスコア
kimchi_premium_history	$0.08	2つの基準価格でのプレミアム時系列
korea_market_snapshot	$0.08	1回の呼び出しで市場概要を取得：プレミアム＋市場＋為替＋翻訳済みヘッドライン
research_consensus_ticker	$0.12	KRX銘柄1つのアナリストコンセンサス。目標株価の平均・中央値・範囲とばらつき、評価の内訳、各証券会社のすべての修正履歴
research_company_ticker	$0.05	1銘柄のアーカイブ済み韓国証券会社レポート（英語で要約）
research_latest	$0.02	対象企業すべての韓国株式調査の最新情報
news_headlines_en	$0.05	英語訳付き韓国語ヘッドライン
crypto_krw_markets	$0.01	UpbitのすべてのKRW市場（出来高上位、上昇銘柄、下落銘柄）
news_headlines	$0.01	韓国語ヘッドライン（未翻訳）
crypto_krw_ticker	$0.005	UpbitのKRW銘柄1つのレート
fx_usdkrw	$0.005	USD/KRWレート

価格は起動時にプロバイダーのカタログから読み込まれるため、この表にはサービスの現在の料金が反映されます。

支払い方法

有料エンドポイントは、支払いのないリクエストに対して、価格、資産、受取人を記載したPAYMENT-REQUIREDヘッダーとともにHTTP 402を返します。このサーバーは、指定された金額のEIP-3009認証に署名して再試行し、ファシリテーターがBase上で決済します。アカウントに資金が預けられることはありません。呼び出しごとに支払い、呼び出しを止めれば支払いも止まります。

ライセンス

MIT