SSI Stock Data MCP Server

目次

• 目次

• 1. はじめに

• 2. 特徴

• 3. クイックスタート

  • 3.1. 前提条件

  • 3.2. ローカル実行

  • 3.3. Docker 実行

• 4. ツール

• 5. 開発

• 6. ライセンス

Related MCP server: Tushare_MCP

1. はじめに

SSI Stock Data MCPは、ベトナム株式の日中取引データを取得するためのモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントやツールは、SSI FastConnect APIを使用して、プログラム的かつ安全に日中取引データを照会できます。

2. 特徴

• [x] 取引所別証券コード一覧

• [x] 銘柄コードの詳細情報を取得する

• [x] インデックスバスケット内の銘柄コードのリストを取得する

• [x] インデックスコードのリストを取得する

• [x] ティックデータごとに銘柄コードの始値、高値、安値、終値、出来高、値情報を取得します。

• [x] 日別に銘柄コードの始値、高値、安値、終値、出来高、値情報を取得します。

• [x] 複合指数の日次取引結果を取得する

• [x] 銘柄コードの日次取引情報を取得する

• [x] Dockerコンテナ化のサポート

• [ ] ストリーミングアダプタ経由でリアルタイムデータを取得できるようにサポート（計画中）

• [ ] MCP経由の注文管理と取引をサポート（将来検討）

3. クイックスタート

3.1. 前提条件

• Python 3.12以上

• uv (高速な依存関係管理用)。

• Docker (オプション、コンテナ化されたデプロイメント用)。

• このMCPサーバーを実行する前に、SSI FastConnectサービスに必ず登録してください。SSI FastConnectに登録して、コンシューマーIDとシークレットを取得できます。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の SSI Stock MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude

3.2. ローカル実行

• リポジトリをクローンします。

# Clone the repository
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git

• 環境変数を設定する

# Set environment variables (see .env.sample)
FC_DATA_URL=https://fc-data.ssi.com.vn/ #optional
FC_DATA_AUTH_TYPE=Bearer #optional
FC_DATA_CONSUMER_ID=your_consumer_id 
FC_DATA_CONSUMER_SECRET=your_consumer_secret  

• サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktopの場合は以下のようになります。

{
  "mcpServers": {
    "SSIStockMCPServer": {
      "command": "uv",
      "args": ["--directory", "full-path", "run", "ssi-stock-mcp-server"],
      "env": {
        "FC_DATA_CONSUMER_ID": "id",
        "FC_DATA_CONSUMER_SECRET": "id",
        "FC_DATA_URL": "https://fc-data.ssi.com.vn/",
        "FC_DATA_AUTH_TYPE": "Bearer"
      }
    }
  }
}

• 新しい構成をロードするには、Claude Desktop を再起動します。

• これで、Claude に自然言語を使用してデータと対話するように依頼できるようになりました。

  • 「chỉ số VN30 hôm nay có gì hot không」

  • 「ボリューム ルームを取得して SSI を取得してください」

  • 「そう sánh vol của SSI với VND trongày hom nay」

  • 「トータルマッチボリュームは SSI トロング 1 トゥアントラリーです」

3.3. Docker 実行

• 事前にビルドされたイメージで実行します (または自分でビルドすることもできます)。

$ docker run -p 8000:8000 
             -e FC_DATA_CONSUMER_ID=id 
             -e FC_DATA_CONSUMER_SECRET=id ghcr.io/archiephan78/ssi-stock-mcp-server

• Claude Desktop で Docker を実行する:

{
  "mcpServers": {
    "SSIStockMCPServer": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "FC_DATA_CONSUMER_ID",
        "-e", "FC_DATA_CONSUMER_SECRET",
        "ghcr.io/archiephan78/ssi-stock-mcp-server:latest"
      ],
      "env": {
        "FC_DATA_CONSUMER_ID": "your_username",
        "FC_DATA_CONSUMER_SECRET": "your_password"
      }
    }
  }
}

この構成では、変数名のみを指定した-eフラグを使用し、 envオブジェクトに実際の値を指定して、Claude Desktop から Docker コンテナーに環境変数を渡します。

4. ツール

MCP サーバーは次のツールを公開します:

• 証券リストを取得する: get_securities_list()

• 証券の詳細を取得する: get_securities_details()

• インデックスを取得: get_index_components()

• リストのインデックスを取得する: get_index_list()

• 毎日の始値、高値、安値、終値を取得する: get_daily_ohlc()

• 日中の始値、高値、安値、終値を取得する: get_intraday_ohlc()

• 日次インデックスを取得: get_daily_index()

• 株価を取得する: get_stock_price()

完全な API の詳細については、 src/ssi_stock_mcp_server/server.pyを参照してください。

5. 開発

貢献を歓迎します！ご提案や改善点がありましたら、問題を報告するか、プルリクエストを送信してください。

このプロジェクトは依存関係の管理にUVを使用しています。お使いのプラットフォームの指示に従ってUVをインストールしてください。

# Clone the repository
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
$ uv venv
$ source .venv/bin/activate  # On Unix/macOS
$ .venv\Scripts\activate     # On Windows
$ uv pip install -e .
# run test
$ pytest

6. ライセンス

アパッチ 2.0

お問い合わせ / サポート

• 問題が発生した場合やサポートが必要な場合は、GitHub で問題を報告してください。

• メールアドレス: 該当なし