Servidor de protocolo de contexto del modelo Schwab

Este es un servidor que implementa el Protocolo de Contexto de Modelo (MCP) para la API de Schwab usando schwab-py y el MCP python-sdk .

Características

• Exponer la funcionalidad de la API de Schwab a través del Protocolo de Contexto de Modelo

• Obtener información de la cuenta y posiciones

• Recuperar cotizaciones de acciones e historial de precios

• Obtenga información del mercado y de los impulsores

• Obtener cadenas de opciones y datos de vencimiento

• Acceder al historial de pedidos y transacciones

• Modificar el estado de la cuenta con herramientas especiales (requiere el indicador --jesus-take-the-wheel )

• Diseñado para integrarse con modelos de lenguaje grandes (LLM)

Related MCP server: Microsoft SQL Server MCP Server

Instalación

# Install with all dependencies
uv add -e .

# Install development dependencies
uv add -e .[dev]

Uso

Autenticación

El primer paso es autenticarse con la API de Schwab y generar un token:

# Authenticate and generate a token
uv run schwab-mcp auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --callback-url YOUR_CALLBACK_URL

Puede configurar estas credenciales a través de variables de entorno para evitar escribirlas cada vez:

• SCHWAB_CLIENT_ID

• SCHWAB_CLIENT_SECRET

• SCHWAB_CALLBACK_URL (predeterminado: https://127.0.0.1:8182 )

De forma predeterminada, el token se guarda en ~/.local/share/schwab-mcp/token.yaml (específico de la plataforma). Puede especificar una ruta diferente:

uv run schwab-mcp auth --token-path /path/to/token.yaml

Se admiten los formatos de token yaml y json y se inferirán a partir de la extensión del archivo.

Ejecución del servidor

Después de la autenticación, puede ejecutar el servidor:

# Run the server with default token path
uv run schwab-mcp server --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --callback-url YOUR_CALLBACK_URL

# Run with a custom token path
uv run schwab-mcp server --token-path /path/to/token.json --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --callback-url YOUR_CALLBACK_URL

# Run with account modification tools enabled
uv run schwab-mcp server --jesus-take-the-wheel --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --callback-url YOUR_CALLBACK_URL

La antigüedad del token está validada: si es mayor a 5 días, se le solicitará que vuelva a autenticarse.

ADVERTENCIA : El uso del indicador --jesus-take-the-wheel habilita herramientas que pueden modificar el estado de su cuenta. Úselo con precaución, ya que esto permite que los LLM cancelen pedidos y potencialmente realicen otras acciones que alteren el estado de la cuenta.

Herramientas disponibles

El servidor expone las siguientes herramientas MCP:

Información sobre fechas y mercados

1. get_datetime - Obtener la fecha y hora actual en formato ISO

2. get_market_hours - Obtener el horario de mercado para un mercado específico

3. get_movers - Obtener movedores para un índice específico

4. get_instruments - Busca instrumentos con un símbolo específico

Información de la cuenta

5. get_account_numbers - Obtener la asignación de los ID de cuenta a los hashes de cuenta

6. get_accounts - Obtener información de todas las cuentas de Schwab vinculadas

7. get_accounts_with_positions - Obtener cuentas con información de posición

8. get_account - Obtener información de una cuenta específica

9. get_account_with_positions - Obtener una cuenta específica con información de posición

10. get_user_preferences : obtiene las preferencias del usuario para todas las cuentas, incluidos los apodos

Pedidos

11. get_order - Obtener detalles de un pedido específico

12. get_orders - Obtener pedidos para una cuenta específica

Citas

13. get_quotes - Obtener comillas para símbolos específicos

Historial de precios

14. get_advanced_price_history : obtenga el historial de precios avanzado de un símbolo específico

15. get_price_history_every_minute - Obtener el historial de precios con frecuencia de minutos

16. get_price_history_every_five_minutes - Obtener el historial de precios con una frecuencia de cinco minutos

17. get_price_history_every_ten_minutes - Obtener el historial de precios con una frecuencia de diez minutos

18. get_price_history_every_fifteen_minutes - Obtener el historial de precios con una frecuencia de quince minutos

19. get_price_history_every_thirty_minutes - Obtener el historial de precios con una frecuencia de treinta minutos

20. get_price_history_every_day - Obtener el historial de precios con frecuencia diaria

21. get_price_history_every_week - Obtener el historial de precios con frecuencia semanal

Opciones

22. get_option_chain - Obtener la cadena de opciones para un símbolo específico

23. get_advanced_option_chain : obtiene la cadena de opciones avanzadas para un símbolo específico

24. get_option_expiration_chain - Obtener información de vencimiento de la opción para un símbolo

Actas

25. get_transactions - Obtener transacciones para una cuenta específica

26. get_transaction - Obtener detalles de una transacción específica

Herramientas de modificación de cuenta (Requiere el indicador --jesus-take-the-wheel )

27. cancel_order - Cancelar un pedido específico

Advertencia de seguridad

El indicador --jesus-take-the-wheel permite a los LLM realizar acciones que pueden modificar el estado de su cuenta, incluidas:

• Cancelación de pedidos

• Otras acciones que pueden tener implicaciones financieras (se agregarán más herramientas en futuras versiones)

Utilice esta bandera únicamente en entornos controlados y comprenda los riesgos que conlleva.

Desarrollo

# Type check
uv run pyright

# Format code
uv run ruff format .

# Lint
uv run ruff check .

# Run tests
uv run pytest

Licencia

Este proyecto está disponible bajo la licencia MIT.