SSI 股票数据 MCP 服务器

1. 简介

SSI 股票数据 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”
- “获取卷室 ngoại đã bán của SSI hôm nay”
- “so sánh vol của SSI với VND trong ngày hôm nay”
- “总比赛量 của SSI trong 1 tuần trở lại đây”

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标志并将环境变量从 Claude Desktop 传递到 Docker 容器，并在env对象中提供实际值。

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.开发

欢迎贡献代码！如果您有任何建议或改进，请提交 issue 或 pull request。

本项目使用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