Financial MCP Server

Servidor MCP financiero

Un servidor de Protocolo de Contexto de Modelo (MCP) personalizado para análisis financiero avanzado, monitorización de acciones e inteligencia de mercado en tiempo real. Este servidor proporciona un conjunto de herramientas y puntos finales de API para la gestión de carteras, resúmenes de mercado, alertas de acciones e información financiera contextual, diseñado para una integración fluida con Claude Desktop y otros clientes compatibles con MCP.

Características principales

• Monitoreo de precios de acciones en tiempo real : realice un seguimiento y alerte sobre los movimientos de precios de las acciones y los umbrales definidos por el usuario.
• Gestión de cartera : agregue, elimine y visualice acciones rastreadas en una cartera persistente.
• Resúmenes del mercado : recupere datos del mercado global en vivo, incluidos índices, principales ganadores/perdedores y titulares de noticias.
• Información financiera contextual : analice las consultas de los usuarios, extraiga entidades financieras, obtenga y resuma noticias relevantes y genere indicaciones prácticas.
• Alertas automatizadas : reciba notificaciones de Telegram sobre umbrales de precios, oportunidades comerciales y errores del sistema.
• Configuración personalizable : configuración de stock y sectores basada en JSON para alertas flexibles.
• Registro robusto y manejo de errores : registros detallados y mensajes de error para transparencia y resolución de problemas.

Descripción general del sistema

Puntos finales y herramientas principales

• contexto_financiero(consulta: str)
  • Extrae tickers y palabras clave de una consulta de usuario, obtiene y resume noticias relevantes y devuelve un contexto estructurado y una solicitud para un análisis posterior.
• resumen_del_mercado()
  • Devuelve un resumen en vivo de los mercados globales, incluidos índices, valores de mayor movimiento y titulares de noticias.
• obtener_portafolio()
  • Recupera la lista actual de acciones rastreadas en la cartera del usuario.
• agregar_stock(ticker: str) / eliminar_stock(ticker: str)
  • Añadir o eliminar una acción del portafolio, con invalidación de caché y verificación.
• alertas_de_cartera(cadena_aleatoria: str)
  • Devuelve todas las alertas activadas para la cartera o para un ticker específico si se proporciona.
• alertas_de_stock_de_comprobación(ticker: str) / alerta_de_stock_única(ticker: str)
  • Devuelve alertas para un stock específico, con manejo detallado de errores.

Alertas automatizadas

• Integración de Telegram : envía alertas formateadas y resúmenes a un chat de Telegram configurado.
• Oportunidades comerciales : detecta y notifica señales comerciales procesables.

Resumen contextual

• Resumidor de noticias : utiliza un LLM local (Ollama/Mistral) para generar resúmenes detallados y etiquetados según el sentimiento de artículos de noticias financieras.
• Generador de indicaciones : crea una indicación teniendo en cuenta el mercado para usarla en LLM o asistentes posteriores.

Estructura de archivos

Configuración y personalización

Configuración de alertas ( config/alerts_config.json )

• Organice las acciones por sector, con umbrales de precios superiores/inferiores y descripciones personalizables.
• Ejemplo de estructura:

Variables de entorno

Configúrelos en un archivo .env o en el entorno de su sistema:

Instalación y ejecución desde Claude Desktop

Prerrequisitos

• Python 3.7+
• Claude Desktop (o cualquier cliente compatible con MCP)
• Credenciales del bot de Telegram (para alertas)
• Conexión a Internet (para datos de mercado/noticias)

Guía paso a paso

1. Clonar el repositorio
   git clone <this-repo-url> cd Finance_MCP_Server
2. Crear y activar un entorno virtual
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Instalar dependencias
   pip install -r requirements.txt
4. Configurar variables de entorno
   • Cree un archivo .env en la raíz del proyecto con sus claves API y tokens:
     TELEGRAM_BOT_TOKEN=your_bot_token TELEGRAM_CHAT_ID=your_chat_id SERPAPI_API_KEY=your_serpapi_key
5. Editar configuraciones de alertas
   • Modifique config/alerts_config.json y config/tech_alerts_config.json para configurar sus existencias, sectores y umbrales.
6. Instalar el servidor MCP con la CLI
   • Utilice la CLI de MCP para instalar y registrar el servidor para Claude Desktop:
     mcp install server.py --name "Financial MCP Server"
   • Esto registrará el servidor como una herramienta MCP personalizada, lo que hará que Claude Desktop y otros clientes MCP puedan descubrirlo.
7. Ejecute el servidor MCP a través de la CLI de MCP
   • Inicie el servidor utilizando la CLI de MCP:
     mcp run server.py
   • El servidor se iniciará y escuchará las solicitudes MCP a través de stdio.
8. Conectarse desde Claude Desktop
   • En Claude Desktop, agregue una nueva conexión de servidor MCP personalizada.
   • Establezca el ejecutable/comando en mcp run server.py (o seleccione el “Financial MCP Server” registrado de la lista CLI de MCP).
   • Claude Desktop se comunicará con el servidor mediante el protocolo MCP, habilitando todas las herramientas y puntos finales descritos.

Ejemplo: Configuración del servidor MCP de Claude Desktop

Después de instalar y registrar el servidor Financial MCP, puede agregarlo a su configuración de Claude Desktop. Aquí tiene un fragmento de ejemplo claude_desktop_config.json :

• Actualice la sección env con sus claves API y tokens reales según sea necesario.
• Esta configuración garantiza que Claude Desktop pueda iniciarse y comunicarse con su servidor Financial MCP utilizando el entorno y los argumentos de línea de comandos correctos.

Uso de sus herramientas en Claude Desktop

Tras instalar y conectar su servidor Financial MCP personalizado, todas las herramientas disponibles aparecerán automáticamente en el menú de herramientas de Claude Desktop. Puede activar o desactivar cada herramienta individualmente, lo que facilita el acceso a funciones como análisis del contexto financiero, resúmenes de mercado, gestión de cartera y alertas de acciones directamente desde la interfaz de Claude.

A continuación se muestra una captura de pantalla que muestra cómo se enumerarán y alternarán las herramientas de su servidor MCP en Claude Desktop:

• Cada herramienta (por ejemplo, financial_context , market_summary , add_stock , etc.) se puede habilitar o deshabilitar según sea necesario.
• Esta integración perfecta le permite interactuar con su servidor de análisis financiero utilizando lenguaje natural y flujos de trabajo basados en herramientas dentro de Claude Desktop.

Ejemplos de uso

• Obtener resumen del mercado : utilice la herramienta market_summary para obtener índices, movimientos y noticias en vivo.
• Administrar cartera : utilice add_stock , remove_stock y get_portfolio para actualizar y ver sus acciones rastreadas.
• Recibir alertas : configure umbrales y reciba notificaciones de Telegram sobre movimientos de precios y oportunidades comerciales.
• Análisis contextual : utilice financial_context para analizar una consulta, extraer tickers y obtener noticias resumidas y un aviso informado sobre el mercado.

Solución de problemas y registros

• Todos los registros se escriben en financial_mcp.log en la raíz del proyecto.
• Para depurar, verifique el archivo de registro y asegúrese de que las variables de entorno y los archivos de configuración sean correctos.
• Si encuentra problemas con Telegram o la búsqueda de noticias, verifique sus claves API y su conexión a Internet.