目次
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 で問題を報告してください。
- メールアドレス: 該当なし