MCP-сервер Financial Modeling Prep

MCP-сервер для рыночных данных Financial Modeling Prep (FMP), созданный с использованием современной модели инструментов/ресурсов/промптов MCP SDK.

Обзор

aigroup-fmp-mcp предоставляет структурированный интерфейс MCP поверх API Financial Modeling Prep для:

• получения котировок в реальном времени и поиска тикеров

• просмотра профилей компаний и финансовой отчетности

• получения прогнозов и рейтингов аналитиков

• анализа технических индикаторов и исторических графиков

• рабочих процессов с календарями отчетности / экономическими событиями

• использования повторно применяемых ресурсов и промптов MCP для задач анализа

Related MCP server: FMP MCP Server

Основные возможности

• 25 инструментов MCP, охватывающих рыночные данные, финансовые показатели, аналитические рабочие процессы, технические индикаторы и календарные данные

• Поддержка ресурсов для шаблонов доступа на основе URI

• Шаблоны промптов для анализа акций, обзора портфеля и предварительного просмотра отчетности

• Полная поддержка stdio MCP с дополнительными HTTP-эндпоинтами для проверки состояния/информации

• Валидация Zod для более безопасной обработки входных данных

• Построен на MCP SDK 1.27.1 с использованием современных API McpServer

Быстрый старт

Требования

• Node.js >= 18

• npm

• Действующий API-ключ FMP

Запуск из локального исходного кода

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-режим

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

По умолчанию HTTP-сервер предоставляет:

• POST /mcp — возвращает 501 в этой сборке

• GET /health — проверка состояния

• GET / — информация о сервере

HTTP-режим в текущей сборке предназначен только для проверки состояния и метаданных службы. Используйте режим stdio для инструментов, ресурсов и промптов MCP.

Конфигурация

Установите свой API-ключ перед запуском сервера:

export FMP_API_KEY="your-api-key"

Получите свой ключ на сайте Financial Modeling Prep.

Конфигурация MCP-клиента

Claude Desktop / совместимые MCP-клиенты

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

Инструменты

Рыночные данные

• get_quote

• search_symbol

• get_market_gainers

• get_market_losers

• get_most_active

• get_sector_performance

• get_sp500_constituents

Финансовая отчетность

• get_company_profile

• get_income_statement

• get_balance_sheet

• get_cash_flow

• get_stock_news

• get_key_metrics

• get_financial_ratios

Данные аналитиков

• get_analyst_estimates

• get_price_target

• get_analyst_ratings

• get_insider_trading

• get_institutional_holders

Технические индикаторы

• get_technical_indicator_rsi

• get_technical_indicator_sma

• get_technical_indicator_ema

• get_historical_chart

Календарные данные

• get_earnings_calendar

• get_economic_calendar

• get_economic_indicator

Ресурсы

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

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

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

• fmp://market/overview

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

Промпты

• stock_analysis

• portfolio_evaluation

• earnings_preview

Структура проекта

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

Разработка

npm install
npm run build
npm run dev

Справочник API

Все инструменты соответствуют эндпоинтам FMP. См. официальную документацию:

• Документация API FMP

Благодарности

Референсный проект

• houtini-ai/fmp-mcp

  • Репозиторий: https://github.com/houtini-ai/fmp-mcp

  • Область применения: общее направление проекта, структура MCP-сервера и организация функций

Спасибо houtini-ai за предыдущую работу с открытым исходным кодом, которая помогла в реализации этого проекта.

Лицензия и использование

Этот проект выпущен под лицензией MIT.

Вы можете использовать, копировать, изменять, объединять, публиковать, распространять, сублицензировать и продавать копии этого программного обеспечения, в том числе в коммерческих целях, при условии сохранения оригинального уведомления об авторских правах и текста лицензии.

Обратите внимание:

• программное обеспечение предоставляется "КАК ЕСТЬ", без каких-либо гарантий

• вы должны сохранить соответствующее уведомление об авторских правах и разрешениях в копиях или существенных частях программного обеспечения

• использование API FMP по-прежнему регулируется собственными условиями обслуживания, квотами, правилами выставления счетов и ограничениями на использование данных Financial Modeling Prep

Полный текст см. в LICENSE.

Поддержка

• Проблемы: https://github.com/jackdark425/aigroup-fmp-mcp/issues

• Репозиторий: https://github.com/jackdark425/aigroup-fmp-mcp