Servidor MCP de Financial Modeling Prep

Servidor MCP para datos de mercado de Financial Modeling Prep (FMP), construido con el modelo moderno de herramientas/recursos/prompts del SDK de MCP.

Descripción general

aigroup-fmp-mcp proporciona una interfaz MCP estructurada sobre la API de Financial Modeling Prep para:

• cotizaciones en tiempo real y búsqueda de símbolos

• perfiles de empresas y estados financieros

• estimaciones y calificaciones de analistas

• indicadores técnicos y gráficos históricos

• flujos de trabajo de calendarios de ganancias / económicos

• recursos y prompts de MCP reutilizables para tareas de análisis

Related MCP server: FMP MCP Server

Aspectos destacados

• 25 herramientas MCP que cubren datos de mercado, finanzas, flujos de trabajo de analistas, indicadores técnicos y datos de calendario

• Soporte de recursos para patrones de acceso basados en URI directos

• Plantillas de prompts para análisis de acciones, revisión de carteras y vista previa de ganancias

• Soporte completo de MCP stdio con endpoints opcionales de salud/información HTTP

• Validación Zod para un manejo de entradas más seguro

• Construido sobre MCP SDK 1.27.1 con APIs modernas de McpServer

Inicio rápido

Requisitos

• Node.js >= 18

• npm

• Una clave de API de FMP válida

Ejecutar con código fuente local

git clone https://github.com/jackdark425/aigroup-fmp-mcp.git
cd aigroup-fmp-mcp
npm install
npm run build
export FMP_API_KEY="your-api-key"
npm start

Modo HTTP

export FMP_API_KEY="your-api-key"
npm run start:http

Por defecto, el servidor HTTP expone:

• POST /mcp — devuelve 501 en esta compilación

• GET /health — comprobación de estado

• GET / — información del servidor

El modo HTTP en la compilación actual está destinado únicamente a comprobaciones de estado y metadatos del servicio. Utilice el modo stdio para herramientas, recursos y prompts de MCP.

Configuración

Establezca su clave de API antes de iniciar el servidor:

export FMP_API_KEY="your-api-key"

Obtenga su clave en Financial Modeling Prep.

Configuración del cliente MCP

Claude Desktop / clientes MCP compatibles

{
  "mcpServers": {
    "fmp": {
      "command": "node",
      "args": ["/path/to/aigroup-fmp-mcp/build/index.js"],
      "env": {
        "FMP_API_KEY": "your-api-key"
      }
    }
  }
}

Herramientas

Datos de mercado

• get_quote

• search_symbol

• get_market_gainers

• get_market_losers

• get_most_active

• get_sector_performance

• get_sp500_constituents

Estados financieros

• get_company_profile

• get_income_statement

• get_balance_sheet

• get_cash_flow

• get_stock_news

• get_key_metrics

• get_financial_ratios

Datos de analistas

• get_analyst_estimates

• get_price_target

• get_analyst_ratings

• get_insider_trading

• get_institutional_holders

Indicadores técnicos

• get_technical_indicator_rsi

• get_technical_indicator_sma

• get_technical_indicator_ema

• get_historical_chart

Datos de calendario

• get_earnings_calendar

• get_economic_calendar

• get_economic_indicator

Recursos

• fmp://company/{symbol}/profile

• fmp://company/{symbol}/quote

• fmp://company/{symbol}/financials/{statement}/{period}

• fmp://market/overview

• fmp://market/sectors/{date}

Prompts

• stock_analysis

• portfolio_evaluation

• earnings_preview

Estructura del proyecto

aigroup-fmp-mcp/
├── src/
│   ├── index.ts
│   ├── server.ts
│   ├── tools/
│   ├── resources/
│   ├── prompts/
│   ├── types/
│   └── utils/
├── package.json
├── tsconfig.json
└── README.md

Desarrollo

npm install
npm run build
npm run dev

Referencia de la API

Todas las herramientas se asignan a los endpoints de FMP. Consulte la documentación oficial:

• Documentación de la API de FMP

Agradecimientos

Proyecto de referencia

• houtini-ai/fmp-mcp

  • Repositorio: https://github.com/houtini-ai/fmp-mcp

  • Alcance de referencia: dirección general del proyecto, estructura del servidor MCP y organización de funciones

Gracias a houtini-ai por el trabajo previo de código abierto que ayudó a informar esta implementación.

Licencia y uso

Este proyecto se publica bajo la Licencia MIT.

Puede usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender copias de este software, incluso en contextos comerciales, siempre que se conserven el aviso de copyright original y el texto de la licencia.

Tenga en cuenta:

• el software se proporciona "TAL CUAL", sin garantía de ningún tipo

• debe conservar el aviso de copyright y permiso relevante en copias o partes sustanciales del software

• el uso de la API de FMP sigue estando sujeto a los propios términos de servicio, cuotas, reglas de facturación y restricciones de uso de datos de Financial Modeling Prep

Consulte el texto completo en LICENSE.

Soporte

• Problemas: https://github.com/jackdark425/aigroup-fmp-mcp/issues

• Repositorio: https://github.com/jackdark425/aigroup-fmp-mcp