プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Korea Stock MCP

作者:jjlabsioバージョン 1.1.4i★ 185iパソコンで動くリポジトリ ↗
レジストリ名io.github.jjlabsio/korea-stock-mcp

インストール方法

What it does

MCP server for korea stock

  • Connects パソコンで動く
  • Account or key Needs DART_API_KEY, KRX_API_KEY
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気27/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア39/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Korea Stock MCP をインストールして。https://mcp.popnx.com/i/jjlabsio-korea-stock-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Korea Stock MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "korea-stock": { "command": "npx", "args": [ "-y", "korea-stock-mcp" ], "env": { "DART_API_KEY": "your-value", "KRX_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DART_API_KEY, KRX_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korea Stock MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Korea Stock MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "korea-stock": {
          "command": "npx",
          "args": [
            "-y",
            "korea-stock-mcp"
          ],
          "env": {
            "DART_API_KEY": "your-value",
            "KRX_API_KEY": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    Korea Stock MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Korea Stock MCP を使っていると言うか、回答に Korea Stock MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Korea Stock MCP につなげません

Korea Stock MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Korea Stock MCP につなげるアプリを使う

  • Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Korea Stock MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user korea-stock --env DART_API_KEY=your-value --env KRX_API_KEY=your-value -- npx -y korea-stock-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DART_API_KEY, KRX_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korea Stock MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Korea Stock MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user korea-stock --env DART_API_KEY=your-value --env KRX_API_KEY=your-value -- npx -y korea-stock-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    Korea Stock MCP が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    Korea Stock MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Korea Stock MCP を使っていると言うか、回答に Korea Stock MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Korea Stock MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "korea-stock": { "command": "npx", "args": [ "-y", "korea-stock-mcp" ], "env": { "DART_API_KEY": "your-value", "KRX_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DART_API_KEY, KRX_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korea Stock MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Korea Stock MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    Korea Stock MCP の設定で DART_API_KEY, KRX_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    Korea Stock MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Korea Stock MCP を使っていると言うか、回答に Korea Stock MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Korea Stock MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Korea Stock MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "korea-stock": { "type": "stdio", "command": "npx", "args": [ "-y", "korea-stock-mcp" ], "env": { "DART_API_KEY": "your-value", "KRX_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DART_API_KEY, KRX_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Korea Stock MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Korea Stock MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    Korea Stock MCP の設定で DART_API_KEY, KRX_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    Korea Stock MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Korea Stock MCP を使っていると言うか、回答に Korea Stock MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Korea Stock MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user korea-stock --env DART_API_KEY=your-value --env KRX_API_KEY=your-value -- npx -y korea-stock-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "korea-stock": {
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp"
      ],
      "env": {
        "DART_API_KEY": "your-value",
        "KRX_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "korea-stock": {
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp"
      ],
      "env": {
        "DART_API_KEY": "your-value",
        "KRX_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "korea-stock": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp"
      ],
      "env": {
        "DART_API_KEY": "your-value",
        "KRX_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • DART_API_KEY 秘密 必須 env
    サービス用の DART API キー
    英語の原文を見るDART API key for the service
  • KRX_API_KEY 秘密 必須 env
    KRX サービスの API キー
    英語の原文を見るKRX API key for the service

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
185/週
接続方法
パソコンで動く
最新バージョンi
1.1.4
カテゴリi
その他
レジストリ公開日i
2025年9月19日
コードの最終更新i
2026年11月19日
作者
jjlabsio
パッケージ
npm: korea-stock-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント jjlabsio で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    ISCを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に korea-stock-mcp@1.1.4 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/jjlabsio-korea-stock-mcp.svg)](https://mcp.popnx.com/en/servers/jjlabsio-korea-stock-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20815件のうち99%よりスターが多い
  • このカテゴリのほかの20815件のうち0%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20815件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Korea Stock MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:DART_API_KEY, KRX_API_KEY

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.1.4)がレジストリに届いたのは14 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万4 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター31 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582414 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Korea Stock MCP
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスISCAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Korea Stock MCP Server

🇰🇷 한국어 | 🇺🇸 English

🚀 Korea Stock MCP가 오픈소스 MCP에서 한 단계 더 나아갑니다.

정확한 한국 주식 데이터를 바탕으로, AI가 더 믿을 수 있는 답변을 제공하도록 돕는 새로운 서비스를 준비하고 있습니다. 새로운 서비스의 방향을 확인해보세요.

한국 주식 분석을 위한 MCP 서버입니다. DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.

💬 개선 요청 & 피드백 환영합니다!

사용하면서 불편한 점이나 개선 아이디어가 있으시면 편하게 이메일 주세요.

빠르게 확인하고 반영하겠습니다.

📧 wowlxx28@gmail.com

🎯 주요 기능

  • 🔍 공시검색 - 회사별, 기간별 공시 검색
  • 📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
  • 💼 재무제표 분석 - XBRL 기반 상세 재무 데이터
  • 📈 주식 데이터 - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보

⚡ 빠른 시작

1️⃣ API KEY 발급

먼저 DART와 KRX의 API KEY를 발급받아야 합니다.

📝 DART API KEY 발급
  1. 회원가입: OPEN DART 회원가입
  2. 키 신청: 인증키 신청 페이지에서 API KEY 신청
  3. 키 확인: 오픈API 이용현황에서 발급된 API KEY 확인
📈 KRX API KEY 발급
  1. 회원가입: KRX OPEN API에서 회원가입 및 로그인
  2. 키 신청: 마이페이지 → API 인증키 신청에서 신청
  3. 서비스 신청: 승인 후 서비스이용 → 주식 메뉴로 이동
  4. API 이용신청: 다음 6개 항목에서 각각 "API 이용신청" 클릭
  • 유가증권 일별매매정보
  • 코스닥 일별매매정보
  • 코넥스 일별매매정보
  • 유가증권 종목기본정보
  • 코스닥 종목기본정보
  • 코넥스 종목기본정보

⏱️ 승인까지 약 1일 소요됩니다.

  1. 키 확인: 승인 후 마이페이지 → API 인증키 발급내역에서 API KEY 확인
2️⃣ Claude Desktop 설정
  1. Claude Desktop 실행
  2. 설정 → 개발자 → 구성편집 클릭
  3. claude_desktop_config.json 파일에 다음 내용 추가:
{

"mcpServers": { "korea-stock-mcp": { "command": "npx", "args": ["-y", "korea-stock-mcp@latest"], "env": { "DART_API_KEY": " ", "KRX_API_KEY": " " } } } }

  1. 재시작: Claude Desktop을 재시작하여 설정 적용

이제 Claude에서 한국 주식 데이터 분석을 시작할 수 있습니다.

대용량 공시 문서 처리

일부 공시보고서(사업보고서, 분기보고서 등)는 수 MB에 달하는 대용량 XML 문서입니다. 이런 문서를 한 번에 모두 처리하면 AI 응답 한도를 초과하거나 오류가 발생할 수 있습니다.

어떻게 동작하나요?

문서 크기에 따라 자동으로 처리 방식이 달라집니다.

  • 소용량 문서 (1MB 미만): 문서 전체를 바로 반환합니다.
  • 대용량 문서 (1MB 이상): 문서 전체 대신 목차(TOC)를 먼저 반환합니다. Claude가 목차를 보고 질문과 관련된 섹션을 자동으로 선택해 내용을 가져옵니다.
유저 안내

별도로 조작할 필요가 없습니다. Claude가 대용량 문서를 자동으로 처리합니다.

문서가 크면 Claude가 자동으로 다음과 같이 동작합니다:

  1. 문서 목차를 확인합니다.
  2. 질문과 관련된 섹션을 자동으로 선택해 내용을 조회합니다.
  3. 답변 후 나머지 섹션 목록을 안내하므로, 추가로 궁금한 섹션이 있으면 요청할 수 있습니다.

예시:

  • "사업보고서에서 매출 현황 알려줘" → Claude가 매출 관련 섹션을 자동 선택
  • "방금 목차에서 3번 섹션도 조회해줘" → 특정 섹션 직접 요청 가능
💡 복잡한 질문은 단계별로 나눠서 질문하세요

한 번에 원하는 답을 얻지 못할 때는, 질문을 여러 단계로 나누면 더 정확한 결과를 얻을 수 있습니다.

예를 들어, "인벤테라의 증권신고서에서 외국인 배정 내역 알려줘"가 한 번에 안 된다면:

  1. "인벤테라의 고유번호(corp_code) 알려줘"
  2. "그 회사의 증권발행 관련 공시 목록 보여줘"
  3. "해당 공시 본문을 가져와줘"
  4. "외국인 배정 내역을 찾아줘"

이렇게 단계별로 진행하면 각 단계의 결과를 확인하면서 원하는 정보에 도달할 수 있습니다.


사용 가능한 도구

DART (전자공시시스템)
  1. get_disclosure_list - 공시검색
  • 공시 유형별, 회사별, 날짜별 공시보고서 검색
  1. get_corp_code - 고유번호 조회
  • DART 등록 공시대상회사의 고유번호, 회사명, 종목코드 제공
  • 회사명(corp_name) 또는 종목코드(stock_code) 중 하나로 조회 가능
  • 회사명 검색 실패 시 종목코드로 재시도 안내
  1. get_disclosure - 공시보고서 원문
  • DART API를 통한 공시보고서 원본파일 파싱
  • 대용량 문서의 경우 목차를 반환하며, section_id로 특정 섹션 조회 가능
  1. get_financial_statement - 재무제표
  • 상장법인 및 주요 비상장법인 XBRL 재무제표
  • 정기보고서 내 모든 계정과목 데이터 제공
KRX (한국거래소)
  1. get_stock_base_info - 종목 기본정보
  • 코스피, 코스닥, 코넥스 상장 종목 기본 정보
  • 종목명, 종목코드, 시장구분 등 기본 데이터
  1. get_stock_trade_info - 일별 매매정보
  • 코스피, 코스닥, 코넥스 종목별 일별 거래 데이터
  • 주가, 거래량, 시가총액 등 상세 거래 정보
  1. get_market_type - 시장구분 조회
  • 종목코드로 해당 종목의 시장구분(코스피/코스닥/코넥스) 조회
  • 주식 데이터 조회 시 필요한 시장 정보 제공
기타 도구
  1. get_today_date - 오늘 날짜 조회
  • 현재 날짜를 YYYYMMDD 형식으로 제공
  • AI의 정확한 날짜 조회를 위한 도구

실제 사용 예시

📊 재무 분석 예제

프롬프트: "삼양식품의 2023년, 2024년 1~4분기, 2025년 1,2분기 매출, 영업이익 조사해주고 성장률도 조사해줘" → 삼양식품 분석 결과 보기

프롬프트: "에이피알의 23년 1분기부터 25년 2분기까지의 매출, 영업이익 성장과 주가, 시가총액 흐름을 조사해줘" → 에이피알 분석 결과 보기

🏢 기업 분석 예제

프롬프트: "HJ중공업은 뭘 해서 돈을 버는 회사인지랑 사업부문별 매출까지 같이 알려줘" → HJ중공업 분석 결과 보기

📑 공시 분석 예제

프롬프트: "Get the foreign allocation details for an IPO (e.g., Inventera / 0007J0)" → 인벤테라 IPO 외국인 배정 분석 결과 보기

API 데이터 소스

  • DART (전자공시시스템): 상장기업 공시 정보 및 재무제표
  • KRX (한국거래소): 종목 기본정보 및 일별 매매정보

로컬 개발 및 테스트

소스를 수정하면서 바로 테스트하는 방법입니다.

1️⃣ 의존성 설치
npm install
2️⃣ 환경변수 설정

프로젝트 루트에 .env 파일을 생성합니다:

DART_API_KEY=your_dart_api_key

KRX_API_KEY=your_krx_api_key

3️⃣ MCP Inspector 실행
npm run inspect

터미널에 출력되는 주소(http://localhost:6274 등)를 브라우저에서 열면 MCP Inspector UI가 열립니다.

Inspector에서 Connect 버튼을 클릭한 후, 좌측 툴 목록에서 원하는 툴을 선택해 직접 호출할 수 있습니다.

4️⃣ 소스 수정 후 재테스트

src/ 파일을 수정하고 저장하면 서버가 자동으로 재시작됩니다. Inspector에서 Reconnect 버튼을 클릭하면 변경사항이 즉시 반영됩니다.

참고: Node.js 18 이상이 필요합니다.

기여하기

기여를 환영합니다! Pull Request를 보내주세요.

  1. 이 저장소를 포크하세요
  2. 기능 브랜치를 만드세요 (git checkout -b feature/AmazingFeature)
  3. 변경사항을 커밋하세요 (git commit -m 'Add some AmazingFeature')
  4. 브랜치에 푸시하세요 (git push origin feature/AmazingFeature)
  5. Pull Request를 열어주세요

라이선스

ISC 라이선스

지원

  • 🐛 이슈가 있다면 GitHub Issues에 등록해주세요
  • ⭐ 유용하다면 스타를 눌러주세요!

면책 조항

본 도구는 정보 제공 목적이며, 투자 조언이 아닙니다. 모든 투자 결정은 본인 책임입니다.


English Version

🚀 Korea Stock MCP is taking the next step beyond an open-source MCP.

Built on reliable Korean stock data, we’re preparing a new service that helps AI deliver answers you can trust. See what we’re building.

MCP Server for Korean stock analysis. Enables AI-powered analysis of stock prices and disclosure data through official APIs from DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange).

💬 Feedback & Feature Requests Welcome!

If you have any ideas for improvement or issues while using this tool, feel free to email me.

I'll review and address them as quickly as possible.

📧 wowlxx28@gmail.com

🎯 Key Features

  • 🔍 Disclosure Search - Search corporate disclosures by company and date
  • 📊 Disclosure Data - Provides parsed data from original disclosure reports
  • 💼 Financial Statement Analysis - Detailed financial data based on XBRL
  • 📈 Stock Data - KRX (KOSPI/KOSDAQ) daily stock prices and basic stock information

⚡ Quick Start

1️⃣ API KEY Registration

You need to obtain API KEYs from both DART and KRX.

📝 DART API KEY Registration
  1. Sign Up: Register at OPEN DART
  2. Request Key: Apply for API KEY at Authentication Key Application Page
  3. Check Key: Verify issued API KEY at Open API Usage Status
📈 KRX API KEY Registration
  1. Sign Up: Register and login at KRX OPEN API
  2. Request Key: Apply for API authentication key in My Page → API Authentication Key Application
  3. Service Application: After approval, go to Service Use → Stock menu
  4. API Usage Application: Click "API Usage Application" for each of the following 6 items
  • Securities Daily Trading Information
  • KOSDAQ Daily Trading Information
  • KONEX Daily Trading Information
  • Securities Basic Information
  • KOSDAQ Basic Information
  • KONEX Basic Information

⏱️ Approval takes approximately 1 day.

  1. Key Verification: After approval, check API KEY in My Page → API Authentication Key Issuance History
2️⃣ Claude Desktop Setup
  1. Launch Claude Desktop
  2. Go to Settings → Developer → Edit Configuration
  3. Add the following content to claude_desktop_config.json:
{

"mcpServers": { "korea-stock-mcp": { "command": "npx", "args": ["-y", "korea-stock-mcp@latest"], "env": { "DART_API_KEY": " ", "KRX_API_KEY": " " } } } }

  1. Restart: Restart Claude Desktop to apply settings

You can now start analyzing Korean stock data with Claude.

Large Disclosure Document Handling

Some disclosure reports (annual reports, quarterly reports, etc.) are large XML documents of several MB. Processing such documents all at once can exceed AI response limits or cause errors.

How does it work?

The processing method changes automatically depending on document size.

  • Small documents (under 1MB): Returns the entire document immediately.
  • Large documents (1MB or more): Returns a Table of Contents (TOC) instead of the full document. Claude reads the TOC and automatically selects and fetches the sections relevant to your question.
User Guide

No manual action required. Claude handles large documents automatically.

When a document is large, Claude automatically:

  1. Checks the document's table of contents.
  2. Selects and fetches the sections relevant to your question.
  3. After answering, lists the remaining sections — so you can request any other section you're curious about.

Examples:

  • "Show me the revenue overview from the annual report" → Claude auto-selects the revenue-related section
  • "Also fetch section 3 from the TOC you just showed" → You can request a specific section directly
💡 Break Complex Questions into Steps

If you can't get the answer you want in one shot, try breaking your question into smaller steps for more accurate results.

For example, instead of "Show me the foreign investor allocation details from Inventera's securities registration statement", try:

  1. "Get the corp_code for Inventera"
  2. "Search for securities issuance disclosures for that company"
  3. "Fetch the document content for that disclosure"
  4. "Find the foreign investor allocation table"

This way, you can verify each step's output and guide Claude toward the exact information you need.


Available Tools

DART (Data Analysis, Retrieval and Transfer System)
  1. get_disclosure_list - Disclosure Search
  • Search disclosure reports by type, company, and date
  1. get_corp_code - Corporate Code Inquiry
  • Provides unique codes, company names, and stock codes of DART-registered disclosure companies
  • Search by company name (corp_name) or stock code (stock_code)
  • If name search fails (e.g. non-Korean input), suggests retrying with stock code
  1. get_disclosure - Disclosure Report Content
  • Parse original disclosure report files through DART API
  • For large documents, returns a TOC; use section_id to fetch a specific section
  1. get_financial_statement - Financial Statements
  • XBRL financial statements for listed and major unlisted companies
  • Provides all account data from periodic reports
KRX (Korea Exchange)
  1. get_stock_base_info - Basic Stock Information
  • Basic information for KOSPI, KOSDAQ, and KONEX listed stocks
  • Basic data including stock names, codes, and market classifications
  1. get_stock_trade_info - Daily Trading Information
  • Daily trading data for KOSPI, KOSDAQ, and KONEX stocks
  • Detailed trading information including stock prices, trading volume, and market capitalization
  1. get_market_type - Market Type Inquiry
  • Query market classification (KOSPI/KOSDAQ/KONEX) by stock code
  • Provides market information needed for stock data queries
Other Tools
  1. get_today_date - Today's Date Inquiry
  • Provides current date in YYYYMMDD format
  • Tool for AI's accurate date inquiry

Real Usage Examples

📊 Financial Analysis Examples

Prompt: "Investigate Samyang Foods's sales and operating profit for Q1-Q4 2023, Q1-Q4 2024, and Q1-Q2 2025, and also check growth rates" → See Samyang Foods Analysis Results

Prompt: "Investigate APR's sales and operating profit growth from Q1 2023 to Q2 2025, along with stock price and market cap trends" → [See APR A

冒頭だけを表示しています。続きはリポジトリで読めます