Servidor MCP de preparación de modelos financieros (FMP)

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los datos de la API de Preparación de Modelado Financiero (FMP) mediante una interfaz estandarizada. Este servidor permite a los asistentes de IA como Claude acceder a datos financieros mediante programación.

Características

• Perfiles de empresas : acceda a información de la empresa, descripciones, capitalizaciones de mercado, recuento de empleados y datos del sector.
• Estados financieros : recuperar estados de resultados, balances generales y estados de flujo de efectivo
• Métricas financieras : obtenga métricas clave, ratios y datos de crecimiento
• Datos de analistas : acceda a estimaciones y recomendaciones de analistas
• Presentaciones ante la SEC : busque y recupere el contenido de las presentaciones ante la SEC
• Transcripciones de las llamadas de ganancias : Obtenga transcripciones de las llamadas de ganancias
• Datos del mercado : acceda a los precios actuales de las acciones y a los rendimientos de los bonos del Tesoro.
• Análisis de la competencia : encuentre empresas competidoras

Instalación

Prerrequisitos

• Python 3.8 o superior
• Gestor de paquetes UV (recomendado) o pip
• Clave API de preparación de modelos financieros

Configuración

1. Clonar este repositorio
2. Cree un archivo .env en la raíz del proyecto con su clave API:
   # Financial Modeling Prep API Configuration FMP_KEY=your_api_key_here # Optional: SEC API Configuration SEC_ACCESS=YourCompanyName YourEmail@example.com
3. Instalar dependencias usando UV (recomendado):
   uv venv uv pip install -r requirements.txt
   O usando pip:
   pip install -r requirements.txt

Ejecución del servidor

Uso de UV (recomendado)

UV proporciona una resolución e instalación de dependencias más rápidas. Para ejecutar el servidor con UV:

El servidor se iniciará y escuchará conexiones en el puerto MCP predeterminado.

Usando pip

Conectando con Claude Desktop

Claude Desktop puede conectarse a servidores MCP para acceder a datos financieros. Aquí te explicamos cómo configurarlo:

1. Descargar Claude Desktop
2. Editar claude_desktop_config.json: "fmp_mcp_server": { "comando": "uv", "args": [ "--directorio", "REEMPLAZARME CON EL DIRECTORIO ABSOLUTO PARA REPOSICIONAR", "ejecutar", "fmp_mcp_server.py" ] }

Ahora Claude puede usar los datos de FMP a través de la interfaz MCP. Puedes pedirle a Claude que:

• Obtener perfiles de empresas
• Recuperar estados financieros
• Encuentre presentaciones ante la SEC
• Acceda a los datos del mercado
• ¡Y más!

Ejemplos de consultas para Claude

Una vez conectado, puedes hacerle preguntas a Claude como:

• "Estoy considerando una inversión con un horizonte de 3 años, ¿es Apple una buena inversión?"
• "Muéstrame el último estado de resultados trimestral de Tesla"
• Encuentre la última presentación del formulario 10-K de Microsoft.
• "¿Cuáles son los principales competidores de Amazon?"
• Obtén la última transcripción de ganancias de Meta

Opciones de configuración

El servidor admite las siguientes variables de entorno:

• FMP_KEY : Su clave API de preparación de modelos financieros (obligatoria)
• SEC_ACCESS : El nombre de su empresa y correo electrónico para acceder a la API de SEC (opcional)

Almacenamiento en caché

El servidor implementa un sistema de almacenamiento en caché para reducir las llamadas a la API y mejorar el rendimiento:

• Los datos financieros se almacenan en caché por trimestre/año
• Los datos del perfil se almacenan en caché mensualmente
• Los datos de precios diarios se almacenan en caché para el día actual.

Los archivos de caché se almacenan en el directorio DataCache .

Explotación florestal

Los registros se escriben en el directorio logs con la rotación habilitada:

• Tamaño máximo del archivo de registro: 10 MB
• Número de archivos de respaldo: 5

Licencia

Licencia MIT

Expresiones de gratitud

• Preparación de modelos financieros para proporcionar la API
• Servidor MCP para la implementación del Protocolo de Contexto de Modelo