目录
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
6. 许可证
Apache 2.0
联系/支持
- 如果您遇到任何问题或需要支持，请在 GitHub 上打开问题。
- 电子邮件：无