SET-MCP

Accede a estados financieros, incluyendo ingresos, balances generales y flujo de efectivo, de empresas listadas en la Bolsa de Valores de Tailandia (SET).

GitHub
13
Prueba este MCPPatrocinado

Documentación

SET-MCP

smithery badge

SET-MCP es un paquete de Python que proporciona herramientas para servir el Protocolo de Contexto de Modelos (MCP) que puede acceder a la Bolsa de Valores de Tailandia (SET). Permite a los agentes de IA recuperar estados financieros completos, incluyendo estados de resultados, balances generales y estados de flujo de efectivo para empresas listadas.

Características

  • Recuperar estados financieros de empresas listadas en SET
  • Soporte para múltiples tipos de estados financieros:
    • Estado de Resultados
    • Balance General
    • Estado de Flujo de Efectivo
  • Recuperación de datos históricos con rangos de fechas personalizables
  • Interfaz de línea de comandos para fácil integración
  • Integración con FastMCP para funcionalidad mejorada

Instalación

El paquete requiere Python 3.11 o superior. Puedes instalarlo usando pip:

pip install set-mcp

Instalación vía Smithery

Para instalar set-mcp para Claude Desktop automáticamente vía Smithery:

npx -y @smithery/cli install set-mcp --client claude

Uso

Interfaz de Línea de Comandos

El paquete proporciona una interfaz de línea de comandos para acceso fácil a los datos financieros:

set-mcp --transport stdio

Uso con uvx

Ejecuta

uvx set-mcp

Uso con pipx

pipx install set-mcp
pipx run set-mcp

Ejemplo de MCP.json

{
    "mcpServers": {
      "set_mcp": {
        "command": "/path/to/bin/uvx", // Edit to your uvx path
        "args": [
            "set-mcp"
        ],
      }
    }
}

Vercel

Próximamente

Opciones disponibles:

  • --port: Puerto para escuchar en SSE (predeterminado: 8000)
  • --host: Host para escuchar (predeterminado: 0.0.0.0)
  • --transport: Tipo de transporte (opciones: stdio, sse, predeterminado: stdio)

Nota: SSE aún no está implementado

API de Python

También puedes usar el paquete programáticamente en tu código Python:

from set_mcp import get_financial_statement

# Get financial statements for a specific company
result = await get_financial_statement(
    symbol="PTT",  # Company symbol
    from_year=2023,
    to_year=2024
)

Desarrollo

Configuración del Entorno de Desarrollo

  1. Clona el repositorio:
git clone https://github.com/yourusername/set-mcp.git
cd set-mcp
  1. Crea y activa un entorno virtual:
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. Instala las dependencias de desarrollo:
pip install -e ".[dev]"

Ejecución de Pruebas

python test_client.py

La salida no debe tener errores

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Autor