Financial Modeling Prep MCP-Server

MCP-Server für Marktdaten von Financial Modeling Prep (FMP), erstellt mit dem modernen MCP SDK Tool/Ressourcen/Prompt-Modell.

Übersicht

aigroup-fmp-mcp bietet eine strukturierte MCP-Schnittstelle für die Financial Modeling Prep API für:

• Echtzeit-Kurse und Symbolsuche

• Unternehmensprofile und Finanzberichte

• Analystenschätzungen und Ratings

• Technische Indikatoren und historische Charts

• Workflows für Gewinn- / Wirtschaftskalender

• Wiederverwendbare MCP-Ressourcen und Prompts für Analyseaufgaben

Related MCP server: FMP MCP Server

Highlights

• 25 MCP-Tools für Marktdaten, Finanzen, Analysten-Workflows, technische Indikatoren und Kalenderdaten

• Ressourcen-Unterstützung für direkte URI-basierte Zugriffsmuster

• Prompt-Vorlagen für Aktienanalysen, Portfolio-Überprüfungen und Gewinnvorschau

• Vollständige stdio MCP-Unterstützung mit optionalen HTTP-Health/Info-Endpunkten

• Zod-Validierung für sicherere Eingabeverarbeitung

• Aufgebaut auf MCP SDK 1.27.1 mit modernen McpServer APIs

Schnellstart

Anforderungen

• Node.js >= 18

• npm

• Ein gültiger FMP-API-Schlüssel

Ausführung mit lokaler Quelle

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

HTTP-Modus

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

Standardmäßig stellt der HTTP-Server Folgendes bereit:

• POST /mcp — gibt in diesem Build 501 zurück

• GET /health — Gesundheitsprüfung

• GET / — Server-Informationen

Der HTTP-Modus im aktuellen Build ist nur für Gesundheitsprüfungen und Dienst-Metadaten vorgesehen. Verwenden Sie den stdio-Modus für MCP-Tools, Ressourcen und Prompts.

Konfiguration

Legen Sie Ihren API-Schlüssel fest, bevor Sie den Server starten:

export FMP_API_KEY="your-api-key"

Erhalten Sie Ihren Schlüssel von Financial Modeling Prep.

MCP-Client-Konfiguration

Claude Desktop / kompatible MCP-Clients

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

Tools

Marktdaten

• get_quote

• search_symbol

• get_market_gainers

• get_market_losers

• get_most_active

• get_sector_performance

• get_sp500_constituents

Finanzberichte

• get_company_profile

• get_income_statement

• get_balance_sheet

• get_cash_flow

• get_stock_news

• get_key_metrics

• get_financial_ratios

Analystendaten

• get_analyst_estimates

• get_price_target

• get_analyst_ratings

• get_insider_trading

• get_institutional_holders

Technische Indikatoren

• get_technical_indicator_rsi

• get_technical_indicator_sma

• get_technical_indicator_ema

• get_historical_chart

Kalenderdaten

• get_earnings_calendar

• get_economic_calendar

• get_economic_indicator

Ressourcen

• 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

Projektstruktur

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

Entwicklung

npm install
npm run build
npm run dev

API-Referenz

Alle Tools sind auf FMP-Endpunkte abgebildet. Siehe die offizielle Dokumentation:

• FMP API-Dokumentation

Danksagungen

Referenzprojekt

• houtini-ai/fmp-mcp

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

  • Referenzumfang: allgemeine Projektausrichtung, MCP-Serverstruktur und Funktionsorganisation

Dank an houtini-ai für die vorherige Open-Source-Arbeit, die dazu beigetragen hat, diese Implementierung zu informieren.

Lizenz & Nutzung

Dieses Projekt wird unter der MIT-Lizenz veröffentlicht.

Sie dürfen Kopien dieser Software verwenden, kopieren, modifizieren, zusammenführen, veröffentlichen, verbreiten, unterlizenzieren und verkaufen, auch in kommerziellen Kontexten, vorausgesetzt, der ursprüngliche Urheberrechtshinweis und der Lizenztext bleiben erhalten.

Bitte beachten Sie:

• die Software wird "WIE BESEHEN" bereitgestellt, ohne jegliche Gewährleistung

• Sie müssen den relevanten Urheberrechts- und Genehmigungshinweis in Kopien oder wesentlichen Teilen der Software beibehalten

• die Nutzung der FMP API unterliegt weiterhin den eigenen Nutzungsbedingungen, Kontingenten, Abrechnungsregeln und Datennutzungsbeschränkungen von Financial Modeling Prep

Siehe den vollständigen Text in LICENSE.

Support

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

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