SSI Stock Data MCP Server

Tabla de contenido

• Tabla de contenido

• 1. Introducción

• 2. Características

• 3. Inicio rápido

  • 3.1. Requisitos previos

  • 3.2. Ejecución local

  • 3.3. Ejecución de Docker

• 4. Herramientas

• 5. Desarrollo

• 6. Licencia

Related MCP server: Tushare_MCP

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.

Instalación mediante herrería

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

• Clonar el repositorio:

# 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

Contacto / Soporte

• Abra un problema en GitHub si encuentra algún problema o necesita ayuda.

• Correo electrónico: n/a