Fonparam MCP

📊 Servidor Fonparam MCP

Este servidor Model Context Protocol (MCP) permite que o Claude Desktop acesse dados de fundos de investimento da Turquia. Você pode obter dados atualizados dos fundos, estatísticas de desempenho e comparações através da API FonParam.

✨ Recursos

• 📈 Listagem de Fundos: Filtrar e pesquisar todos os fundos de investimento
• 🔍 Comparação de Fundos: Analisar comparando 2 a 5 fundos
• 📊 Análise de Desempenho: Análise de investimento em fundos e cálculo de retorno
• 🏢 Informações de Empresas: Empresas de gestão de portfólio e estatísticas
• 📈 Dados Históricos: Dados de desempenho histórico dos fundos
• 📊 Estatísticas: Estatísticas diárias do mercado
• 💰 Dados de Inflação: Taxas de inflação da Turquia

🚀 Instalação

Opção 1: Instalação via NPM (Recomendado)

Como o pacote NPM é executado automaticamente, não é necessária instalação separada. Você pode executar o pacote usando npx na configuração do Claude Desktop.

Opção 2: Instalação a partir do Código Fonte

1. Instale as Dependências

npm install

2. Compile o Projeto

npm run build

Configuração do Claude Desktop

Adicione a seguinte configuração ao arquivo claude_desktop_config.json do Claude Desktop:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Configuração:

Se estiver usando o pacote NPM (recomendado):

{
  "mcpServers": {
    "fonparam": {
      "command": "npx",
      "args": ["-y", "fonparam-mcp"],
      "env": {}
    }
  }
}

Se instalou a partir do código fonte:

{
  "mcpServers": {
    "fonparam": {
      "command": "node",
      "args": ["/tam/yol/to/fonparam-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Nota: Para instalação a partir do código fonte, substitua /tam/yol/to/fonparam-mcp pelo caminho real do seu projeto.

4. Reinicie o Claude Desktop

Após adicionar a configuração, feche e reabra o Claude Desktop.

🛠️ Ferramentas Disponíveis

📊 Ferramentas de Fundos

• list_funds: Lista e filtra fundos
• top_performing_funds: Obtém os fundos com melhor desempenho
• compare_funds: Compara fundos (2 a 5 fundos)
• analyze_fund: Realiza análise de investimento em fundos
• fund_historical_data: Obtém valores históricos do fundo

🏢 Ferramentas de Empresas

• list_companies: Lista empresas de gestão de portfólio
• company_details: Obtém detalhes da empresa

📈 Ferramentas de Estatísticas

• statistics: Lista estatísticas diárias
• latest_statistics: Obtém as estatísticas mais recentes
• statistics_by_date: Obtém estatísticas de uma data específica

🎯 Ferramentas de Tipos de Fundos

• list_fund_types: Lista tipos de fundos
• fund_type_details: Obtém detalhes do tipo de fundo

💰 Ferramentas de Inflação

• inflation_rates: Lista dados de inflação
• latest_inflation_rate: Obtém o dado de inflação mais recente
• monthly_inflation_rate: Obtém dado de inflação de mês/ano específico

💡 Exemplos de Uso

Comandos de Exemplo no Claude Desktop:

En iyi performans gösteren 10 fonu göster

"ATA PORTFÖY" şirketine ait fonları listele

AAK ve DAH fonlarını karşılaştır

AAK fonuna 10.000 TL yatırıp yıl başından bugüne kadar kaç para olacağını hesapla

Hisse senedi fonlarının bu ayki performansını göster

Son enflasyon verilerini göster

🔧 Desenvolvimento

Scripts

# TypeScript derlemesi (watch mode)
npm run dev

# Projeyi derle
npm run build

# Sunucuyu başlat
npm start

# Derleme dosyalarını temizle
npm run clean

Estrutura do Projeto

src/
├── index.ts          # Ana MCP sunucusu
├── api-client.ts     # FonParam API client
├── tools.ts          # MCP araçları tanımları
└── types.ts          # TypeScript tip tanımları

🤝 Contribuição

1. Faça um fork do repositório
2. Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'feat: amazing new feature')
4. Envie o branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

📜 Licença

Este projeto é licenciado sob a licença MIT.

🔗 Links

• Documentação da API FonParam
• Model Context Protocol
• Claude Desktop

⚠️ Nota

Este servidor utiliza a camada gratuita da API FonParam e está sujeito às regras de limite de requisições:

• Máximo de 25 requisições em 15 minutos
• Máximo de 100 requisições por dia

Para uso intenso, considere obter uma chave de API.