内容
[](https://mseep.ai/app/archiephan78-ssi-stock-mcp-server)
<div align="center">
<h1>股票数据 MCP 服务器</h1>
<p>
<a href="https://github.com/archiephan78/ssi-stock-mcp-server/blob/main/LICENSE">
<img alt="GitHub 许可证" src="https://img.shields.io/github/license/archiephan78/ssi-stock-mcp-server?style=for-the-badge">
</a>
<a href="https://github.com/archiephan78/ssi-stock-mcp-server/stargazers">
<img alt="GitHub 星标" src="https://img.shields.io/github/stars/archiephan78/ssi-stock-mcp-server?style=for-the-badge">
</a>
</div>
## 目录
- [目录](#目录)
- [1. 简介](#1-简介)
- [2. 功能](#2-功能)
- [3. 快速开始](#3-快速开始)
- [3.1. 前置条件](#31-前置条件)
- [3.2. 本地运行](#32-本地运行)
- [3.3. Docker 运行](#33-docker-运行)
- [4. 工具](#4-工具)
- [5. 开发](#5-开发)
- [6. 许可证](#6-许可证)
## 1. 简介
股票数据 MCP 服务器是一个 [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) 服务器,用于获取越南股票日内数据。它使 AI 助手和工具能够使用 [SSI FastConnect API](https://guide.ssi.com.vn/ssi-products/tieng-viet/fastconnect-data) 以编程方式和安全地查询日内数据。
## 2. 功能
- [x] 按交易所列出股票代码
- [x] 检索股票代码的详细信息
- [x] 检索指数篮子中的股票代码列表
- [x] 检索指数代码列表
- [x] 按每个 tick 数据检索股票代码的开盘价、最高价、最低价、收盘价、成交量和成交额
- [x] 按日检索股票代码的开盘价、最高价、最低价、收盘价、成交量和成交额
- [x] 检索综合指数的日交易结果
- [x] 检索股票代码的日交易信息
- [x] Docker 容器化支持
- [ ] 通过流适配器获取实时数据(规划中)
- [ ] 通过 MCP 支持订单管理和交易(未来考虑)
## 3. 快速开始
### 3.1. 前置条件
- Python 3.12+
- [uv](https://github.com/astral-sh/uv)(用于快速依赖管理)
- Docker(可选,用于容器化部署)
- 确保在运行此 MCP 服务器之前注册 SSI FastConnect 服务。您可以在 [SSI FastConnect](https://guide.ssi.com.vn/ssi-products/tieng-viet/dang-ky-dich-vu) 注册以获取您的消费者 ID 和密钥。
### 通过 Smithery 安装
通过 [Smithery](https://smithery.ai/server/@archiephan78/ssi-stock-mcp-server) 自动安装股票 MCP 服务器:
```bash
npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude
```
### 3.2. 本地运行
- 克隆仓库:
```bash
# 克隆仓库
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
```
- 配置环境变量
```shell
# 设置环境变量(参见 .env.sample)
FC_DATA_URL=https://fc-data.ssi.com.vn/ #可选
FC_DATA_AUTH_TYPE=Bearer #可选
FC_DATA_CONSUMER_ID=您的消费者 ID
FC_DATA_CONSUMER_SECRET=您的消费者密钥
```
- 将服务器配置添加到您的客户端配置文件中。例如,对于 Claude Desktop:
```json
{
"mcpServers": {
"SSIStockMCPServer": {
"command": "uv",
"args": ["--directory", "完整路径", "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 使用自然语言与数据交互:
- "今天的 VN30 指数有什么热点?"
- "获取今天的 SSI 外资净卖出量"
- "比较今天的 SSI 和 VND 的成交量"
- "最近一周的 SSI 总成交量"


### 3.3. Docker 运行
- 使用预构建的镜像运行(或者您可以自己构建):
```bash
$ 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 运行:
```json
{
"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": "您的用户名",
"FC_DATA_CONSUMER_SECRET": "您的密码"
}
}
}
}
```
此配置通过在 `-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](src/ssi_stock_mcp_server/server.py)。
## 5. 开发
欢迎贡献!如果您有任何建议或改进,请提出问题或提交拉取请求。
该项目使用 [uv](https://github.com/astral-sh/uv) 管理依赖项。按照您所在平台的说明安装 uv。
```bash
# 克隆仓库
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
$ uv venv
$ source .venv/bin/activate # 在 Unix/macOS 上
$ .venv\Scripts\activate # 在 Windows 上
$ uv pip install -e .
# 运行测试
$ pytest
```
## 6. 许可证
[Apache 2.0](LICENSE)
## 联系/支持
- 如果您遇到任何问题或需要支持,请在 GitHub 上提出问题。
- 邮箱:无