VNStock MCP Server

自然言語処理機能を使って Claude Desktop とやり取りできる、ベトナム株式市場の金融データを提供する非公式 MCP サーバーです。

機能

• デュアルトランスポート対応：STDIO（ローカル）または HTTP（クラウド）のトランスポートを自動検出します
• クラウドへのデプロイ：Render.com の無料プランにワンクリックでデプロイできます
• LLM を活用：Anthropic Claude による自然言語処理
• 見やすい出力：整形された表、チャート、データの視覚化
• ツール管理：ツールの自動検出と検証
• スマート解析：ベトナム株式の銘柄コードと日付形式に対応
• エラー処理：堅牢なエラー回復とわかりやすいメッセージ

クイックスタート

# Install from PyPI and run directly
uvx vnstock-mcp@latest

使用例

> Show me FPT's income statements for 2024
> What are HPG's key financial ratios?

データソース

このサーバーは、vnstock 4.x のパブリックアダプターを使用します。

• 財務諸表と財務比率では、item、item_id、期間列の一貫した出力を得るために Finance(source="KBS") を使用します。財務項目名はプロバイダー固有の名称です。指標を安定して特定するには item_id を使用してください。
• 企業情報では、ratio_summary と trading_stats が VCI 固有の互換メソッドであるため、Company(source="VCI") を使用します。
• 投資信託データでは、トップレベルの Fund アダプターを使用します。

財務諸表と財務比率のレスポンスは、期間列を持つ指標行として返されます。

item | item_id | 2025 | 2024 | 2023 | 2022

企業情報の種類 reports は vnstock 4.x ではサポートされていないため、削除されました。

Claude Desktop との連携

この MCP サーバーを Claude Desktop で使用するには、次の設定を Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）に追加してください。

方法 1：uvx を使用（PATH が設定されている場合）

{
  "mcpServers": {
    "vnstock-mcp": {
      "command": "uvx",
      "args": ["vnstock-mcp"]
    }
  }
}

方法 2：uvx を使用（PATH が設定されていない場合）

{
  "mcpServers": {
    "vnstock-mcp": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["vnstock-mcp"]
    }
  }
}

方法 3：ソースから開発（スクリプトパス）

{
  "mcpServers": {
    "vnstock-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/USERNAME/PATH_TO/src/vnstock_mcp",
        "run",
        "server.py"
      ]
    }
  }
}

方法 4：ソースから開発（Python モジュール）

{
  "mcpServers": {
    "vnstock-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/USERNAME/PATH_TO/vnstock-mcp",
        "run",
        "python",
        "-m",
        "vnstock_mcp.server"
      ]
    }
  }
}

方法 5：Docker MCP Gateway（簡単な方法）

{
  "mcpServers": {
    "MCP_DOCKER": {
      "type": "stdio",
      "command": "docker",
      "args": ["mcp", "gateway", "run"]
    }
  }
}

方法 6：Docker MCP Gateway（カタログ／レジストリを明示的に指定）

{
  "mcpServers": {
    "mcp-toolkit-gateway": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "-v",
        "/Users/YOUR_USERNAME/.docker/mcp:/mcp",
        "docker/mcp-gateway",
        "--catalog=/mcp/catalogs/vnstock.yaml",
        "--config=/mcp/config.yaml",
        "--registry=/mcp/registry.yaml",
        "--transport=stdio"
      ]
    }
  }
}

注：

• 方法 2 と 6 では、YOUR_USERNAME を実際のユーザー名に置き換えてください
• 方法 3 と 4 では、USERNAME と PATH_TO を実際のユーザー名とパスに置き換えてください
• 方法 5 と 6 には、MCP Toolkit を有効にした Docker Desktop が必要です。詳しくはセットアップガイドを参照してください
• 方法 5 では Docker がカタログを自動的に管理します。方法 6 では特定のカタログ、設定ファイル、レジストリファイルを固定します
• Claude Desktop を終了して再起動しても MCP サーバーが検出されない場合は、uvx が PATH に含まれているか確認してください。含まれていない場合は、~/.local/bin を PATH に追加してください。

# For zsh (macOS default)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# For bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Claude Code との連携

claude mcp add vnstock-mcp --transport http https://your-app.onrender.com/mcp

リモート MCP サーバー

ローカルに何もインストールせずに、Render（または任意のクラウドプロバイダー）にデプロイされたホスト型 VNStock MCP サーバーに接続できます。リモートサーバーは /mcp に Streamable HTTP エンドポイントを公開します。

各クライアントの GUI でリモート MCP サーバーを追加する際は、サーバー URL https://your-app.onrender.com/mcp を使用してください。クライアントごとの手順：

• Claude Desktop — 「設定」>「MCP Servers」から追加します
• Claude Code（CLI） — claude mcp add vnstock-mcp https://your-app.onrender.com/mcp --transport http
• Perplexity — カスタムリモートコネクターの追加の手順に従ってください

注： your-app.onrender.com を実際の Render デプロイ URL に置き換え、末尾に /mcp を追加してください。

次のように、カスタムのヘルスエンドポイント /health を使ってサーバーが稼働していることを確認できます。

curl https://your-app.onrender.com/health

タグ付きの Git チェックアウトからサービスを実行している場合、/health の version フィールドにはそのタグが表示されます。.git のないパッケージ環境やデプロイ環境では、インストール済みパッケージのメタデータ、または VNSTOCK_MCP_VERSION が使用されます。

開発

Docker MCP ゲートウェイのセットアップについては、セットアップガイドを参照してください。

プロジェクト構成、Docker ビルド、デプロイガイドについては、開発ガイドを参照してください。

一般的な問題の解決に役立つヒント（クイック診断コマンド、カタログやレジストリの確認、Claude Config の検証、認証と権限）については、トラブルシューティングガイドを参照してください。

ライセンス

このプロジェクトは vnstock ライブラリのラッパーです。ライセンスと API 情報については、メインリポジトリとドキュメントを参照してください。

• vnstock GitHub リポジトリ
• vnstock 4.x リリースノート
• vnstock アーキテクチャドキュメント