Servidor MCP para Shioaji

Un servidor de Protocolo de Contexto Modelo (MCP) que proporciona a los asistentes de IA acceso a la API comercial de Shioaji para el mercado financiero taiwanés.

Descripción general

Este servidor implementa el protocolo MCP para exponer la funcionalidad de la API de Shioaji como herramientas que pueden ser utilizadas por los asistentes de IA. Permite a los modelos de IA:

• Recuperar precios de acciones actuales

• Obtener datos históricos

• Listado de existencias disponibles

• Y más...

Related MCP server: Financial Datasets MCP Server

Instalación

Prerrequisitos

• Python 3.10 o superior

• uv (gestor rápido de paquetes de Python)

Usando uv

uv sync

Configuración

Antes de ejecutar el servidor, debe configurar sus credenciales de la API de Shioaji. Hay dos maneras de hacerlo:

Variables de entorno

Establezca las siguientes variables de entorno:

export SHIOAJI_API_KEY="your_api_key"
export SHIOAJI_SECRET_KEY="your_secret_key"

Usando el archivo .env

Cree un archivo .env en el directorio raíz con el siguiente contenido:

SHIOAJI_API_KEY=your_api_key
SHIOAJI_SECRET_KEY=your_secret_key

Ejecución del servidor

Inicie el servidor con:

uv run mcp-server-shioaji

El servidor se iniciará en http://0.0.0.0:8000 de forma predeterminada.

Herramientas disponibles

El servidor expone las siguientes herramientas a través de MCP:

obtener_precio_de_stock

Obtenga el precio actual de una acción por su símbolo.

{
  "tool": "get_stock_price",
  "params": {
    "symbols": "TW.2330,TW.2317"
  }
}

La respuesta incluirá información sobre precios de las acciones solicitadas, incluidos precios de apertura, máximos, mínimos y cierre, volumen y otros datos comerciales.

obtener_kbars

Obtenga datos de K-Bar (velas) para una acción dentro de un rango de fechas.

{
  "tool": "get_kbars",
  "params": {
    "symbol": "TW.2330",
    "start_date": "2023-12-01",
    "end_date": "2023-12-15"
  }
}

Si no se proporciona start_date , el valor predeterminado es hoy. Si no se proporciona end_date , el valor predeterminado es el mismo que el de start_date .

escanear_stocks

Escanee acciones en función de varios criterios de clasificación.

{
  "tool": "scan_stocks",
  "params": {
    "scanner_type": "VolumeRank",
    "ascending": false,
    "limit": 10
  }
}

Tipos de escáneres compatibles:

• VolumeRank : clasificación por volumen de operaciones

• AmountRank - Clasificación por monto de operaciones

• TickCountRank - Clasificación por número de transacciones

• ChangePercentRank - Clasificación por cambio porcentual

• ChangePriceRank - Clasificación por cambio de precio

• DayRangeRank - Clasificación por rango diario

El límite predeterminado es 20 y los resultados se ordenan en orden descendente de manera predeterminada (establezca ascending como true para orden ascendente).

Desarrollo

Estructura del proyecto

mcp-server-shioaji/
├── src/
│   └── mcp_server_shioaji/
│       ├── __init__.py      # Package entry point
│       └── server.py        # MCP server implementation
├── pyproject.toml           # Project metadata and dependencies
└── README.md                # This file

Agregar nuevas herramientas

Para agregar nueva funcionalidad de Shioaji, modifique server.py y agregue nuevas definiciones de herramientas usando el decorador @mcp.tool .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

• Shioaji : el contenedor de Python para la API comercial de SinoPac

• MCP - Protocolo de Contexto Modelo