SSI株価データ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