remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides configuration management for Shioaji API credentials through a .env file, allowing secure storage of API and secret keys.
Serves as the runtime environment for the MCP server that interfaces with the Shioaji trading API, enabling financial market data access for Taiwan stocks.

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...

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested