FMP MCP Server

Servidor MCP de FMP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas, recursos y avisos para el análisis financiero utilizando la API de Financial Modelling Prep.

Características

Herramientas

• get_company_profile: Obtén información completa de la empresa
• get_stock_quote: Cotizaciones de acciones en tiempo real y datos de mercado
• get_financial_statements: Datos de estado de resultados, balance general y flujo de caja
• get_key_metrics: Métricas financieras clave y KPIs
• get_financial_ratios: Ratios financieros completos para el análisis
• get_dcf_valuation: Valoración de flujo de caja descontado
• search_companies: Busca empresas por nombre o símbolo
• get_sector_performance: Resumen del rendimiento del sector de mercado

Recursos

• Sectores de Mercado: Datos de rendimiento del sector en tiempo real
• Perfiles de Empresa: Información detallada de la empresa
• Estados Financieros: Datos completos de estados financieros

Avisos

• financial_analysis: Flujo de trabajo integral de análisis financiero
• investment_research: Informe detallado de investigación de inversiones
• sector_analysis: Análisis de rendimiento y comparación del sector

Configuración

1. Instalar dependencias:

   uv sync
   

2. Configurar el acceso a la API:

   cp .env.example .env
   # Edit .env and add your Financial Modelling Prep API key
   

3. Obtener la clave de API:

   • Visita Financial Modelling Prep
   • Regístrate para obtener una cuenta
   • Copia tu clave de API al archivo .env

Uso

Con Claude Code

Agrega a tu configuración de MCP de Claude Code:

{
  "mcpServers": {
    "fmp": {
      "command": "uv",
      "args": ["run", "python", "-m", "fmp_mcp_server.server"],
      "env": {
        "FMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Uso Directo

# Run the server
uv run python -m fmp_mcp_server.server

# Or use the installed script
uv run fmp-mcp-server

Uso con Docker

Construir y ejecutar con Docker

# Build the image
docker build -t fmp-mcp-server .

# Run with environment file
docker run --env-file .env fmp-mcp-server

Usando Docker Compose

# Start the service
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the service
docker-compose down

Usando imagen preconstruida desde GitHub Container Registry

docker run --env-file .env ghcr.io/ccdatatraits/fmp-mcp-server:latest

Desarrollo

1. Instalar con dependencias de desarrollo:

   uv sync --dev
   

2. Ejecutar pruebas:

   uv run pytest
   

3. Formatear código:

   uv run black src/
   uv run ruff check src/
   

4. Verificación de tipos:

   uv run mypy src/
   

Límites de Tasa de la API

La API de Financial Modelling Prep tiene límites de tasa según tu suscripción:

• Gratis: 250 solicitudes/día
• Inicial: 300 solicitudes/minuto
• Profesional: 2000 solicitudes/minuto

Configura el límite de tasa en tu archivo .env si es necesario.

Licencia

Licencia MIT