FMP MCP Server

Fornece ferramentas, recursos e prompts para análise financeira usando a API Financial Modelling Prep.

Documentação

Servidor MCP FMP

Um servidor Model Context Protocol (MCP) que fornece ferramentas, recursos e prompts para análise financeira usando a API Financial Modelling Prep.

Recursos

Ferramentas

get_company_profile: Obtenha informações abrangentes da empresa
get_stock_quote: Cotações de ações em tempo real e dados de mercado
get_financial_statements: Dados de demonstração de resultados, balanço patrimonial e fluxo de caixa
get_key_metrics: Principais métricas financeiras e KPIs
get_financial_ratios: Índices financeiros abrangentes para análise
get_dcf_valuation: Avaliação por fluxo de caixa descontado
search_companies: Pesquise empresas por nome ou símbolo
get_sector_performance: Visão geral do desempenho dos setores do mercado

Recursos

Setores de Mercado: Dados de desempenho do setor em tempo real
Perfis de Empresas: Informações detalhadas da empresa
Demonstrações Financeiras: Dados completos das demonstrações financeiras

Prompts

financial_analysis: Fluxo de trabalho abrangente de análise financeira
investment_research: Relatório detalhado de pesquisa de investimento
sector_analysis: Análise de desempenho e comparação de setores

Configuração

Instale as dependências:
```
uv sync
```

Configure o acesso à API:

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

Obtenha a chave da API:
- Visite Financial Modelling Prep
- Cadastre-se para criar uma conta
- Copie sua chave da API para o arquivo .env

Uso

Com o Claude Code

Adicione à sua configuração MCP do Claude Code:

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

Uso Direto

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

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

Uso com Docker

Compile e execute com 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 imagem pré-construída do GitHub Container Registry

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

Desenvolvimento

Instale com dependências de desenvolvimento:
```
uv sync --dev
```
Execute os testes:
```
uv run pytest
```

Formate o código:

uv run black src/
uv run ruff check src/

Verificação de tipos:
```
uv run mypy src/
```

Limites de Taxa da API

A API Financial Modelling Prep possui limites de taxa dependendo da sua assinatura:

Gratuito: 250 solicitações/dia
Starter: 300 solicitações/minuto
Profissional: 2000 solicitações/minuto

Configure a limitação de taxa no seu arquivo .env se necessário.

Licença

Licença MIT