Tabla de contenido
1. Introducción
SSI Stock Data MCP es un servidor de Protocolo de Contexto de Modelo (MCP) para obtener datos intradiarios de las acciones de Vietnam. Permite que los asistentes y herramientas de IA consulten datos intradiarios mediante la API SSI FastConnect de forma programática y segura.
2. Características
- [x] Listado de códigos bursátiles por bolsa
- [x] Recuperar información detallada de un código de stock
- [x] Recuperar la lista de códigos de acciones en una cesta de índice
- [x] Recuperar la lista de códigos de índice
- [x] Recupere la información de apertura, máximo, mínimo, cierre, volumen y valor de un código de acciones por cada dato de tick
- [x] Recupere la información de apertura, máximo, mínimo, cierre, volumen y valor de un código de acciones por día
- [x] Recuperar los resultados comerciales diarios del índice compuesto
- [x] Recuperar la información comercial diaria de un código bursátil
- [x] Compatibilidad con contenedores Docker
- [ ] Admite la obtención de datos en tiempo real a través del adaptador de transmisión (planificación)
- [ ] Soporte para gestión de órdenes y comercio a través de MCP (consideración futura)
3. Inicio rápido
3.1. Requisitos previos
- Python 3.12+
- uv (para una gestión rápida de dependencias).
- Docker (opcional, para implementación en contenedores).
- Asegúrese de registrarse en el servicio SSI FastConnect antes de ejecutar este servidor MCP. Puede registrarse en SSI FastConnect para obtener su ID de consumidor y su clave secreta.
Para instalar SSI Stock MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude
3.2. Ejecución local
# Clone the repository
$ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
- Configurar las variables de entorno
# 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
- Agregue la configuración del servidor al archivo de configuración del cliente. Por ejemplo, para 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"
}
}
}
}
- Reinicie Claude Desktop para cargar la nueva configuración.
- Ahora puedes pedirle a Claude que interactúe con los datos usando lenguaje natural:
- "chỉ số VN30 hôm nay có gì hot không"
- "obtener sala de volumen ngoại đã bán của SSI hôm nay"
- "Así que sánh vol của SSI với VND trong ngày hôm nay"
- "partido total de SSI durante 1 día"
3.3. Ejecución de Docker
- Ejecútalo con una imagen preconstruida (o puedes construirla tú mismo):
$ docker run -p 8000:8000
-e FC_DATA_CONSUMER_ID=id
-e FC_DATA_CONSUMER_SECRET=id ghcr.io/archiephan78/ssi-stock-mcp-server
- Ejecutando con Docker en Claude Desktop:
{
"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"
}
}
}
}
Esta configuración pasa las variables de entorno de Claude Desktop al contenedor Docker utilizando el indicador -e con solo el nombre de la variable y proporcionando los valores reales en el objeto env .
4. Herramientas
El servidor MCP expone herramientas:
- Obtener lista de valores:
get_securities_list() - Obtener detalles de valores:
get_securities_details() - Obtener índice:
get_index_components() - Obtener el índice de la lista:
get_index_list() - Obtener precios de apertura, máximo, mínimo y cierre diarios:
get_daily_ohlc() - Obtener la apertura, máximo, mínimo y cierre intradía:
get_intraday_ohlc() - Obtener el índice diario:
get_daily_index() - Obtener el precio de las acciones:
get_stock_price()
Consulte src/ssi_stock_mcp_server/server.py para obtener detalles completos de la API.
5. Desarrollo
¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios si tiene alguna sugerencia o mejora.
Este proyecto utiliza uv para gestionar dependencias. Instale uv siguiendo las instrucciones para su plataforma.
# 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. Licencia
Apache 2.0
- Abra un problema en GitHub si encuentra algún problema o necesita ayuda.
- Correo electrónico: n/a