Fonparam MCP

📊 Servidor MCP de FonParam

Este servidor de Model Context Protocol (MCP) permite que Claude Desktop acceda a los datos de fondos de inversión en Turquía. A través de la API de FonParam puede obtener datos actualizados, estadísticas de rendimiento y comparaciones de los fondos.

✨ Características

• 📈 Listado de Fondos: Filtrado y búsqueda de todos los fondos de inversión
• 🔍 Comparación de Fondos: Análisis comparando 2-5 fondos
• 📊 Análisis de Rendimiento: Análisis de inversión en fondos y cálculo de retorno
• 🏢 Información de Empresas: Empresas de gestión de carteras y sus estadísticas
• 📈 Datos Históricos: Datos de rendimiento histórico de los fondos
• 📊 Estadísticas: Estadísticas diarias del mercado
• 💰 Datos de Inflación: Tasas de inflación de Turquía

🚀 Instalación

Opción 1: Instalación con NPM (Recomendada)

Dado que el paquete NPM se ejecutará automáticamente, no se requiere instalación adicional. Puede ejecutar el paquete usando npx en la configuración de Claude Desktop.

Opción 2: Instalación desde el código fuente

1. Instale las dependencias

npm install

2. Compile el proyecto

npm run build

Configuración de Claude Desktop

Agregue la siguiente configuración al archivo claude_desktop_config.json de 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

Configuración:

Si usa el paquete NPM (recomendado):

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

Si instaló desde el código fuente:

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

Nota: Para la instalación desde el código fuente, reemplace /tam/yol/to/fonparam-mcp con la ruta real de su proyecto.

4. Reinicie Claude Desktop

Después de agregar la configuración, cierre y vuelva a abrir Claude Desktop.

🛠️ Herramientas Disponibles

📊 Herramientas de Fondos

• list_funds: Lista y filtra fondos
• top_performing_funds: Obtiene los fondos con mejor rendimiento
• compare_funds: Compara fondos (2-5 fondos)
• analyze_fund: Realiza análisis de inversión en fondos
• fund_historical_data: Obtiene los valores históricos del fondo

🏢 Herramientas de Empresas

• list_companies: Lista las empresas de gestión de carteras
• company_details: Obtiene los detalles de la empresa

📈 Herramientas de Estadísticas

• statistics: Lista las estadísticas diarias
• latest_statistics: Obtiene las últimas estadísticas
• statistics_by_date: Obtiene las estadísticas de una fecha específica

🎯 Herramientas de Tipos de Fondos

• list_fund_types: Lista los tipos de fondos
• fund_type_details: Obtiene los detalles del tipo de fondo

💰 Herramientas de Inflación

• inflation_rates: Lista los datos de inflación
• latest_inflation_rate: Obtiene el último dato de inflación
• monthly_inflation_rate: Obtiene el dato de inflación de un mes/año específico

💡 Ejemplos de Uso

Comandos de ejemplo en 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

🔧 Desarrollo

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

Estructura del Proyecto

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ı

🤝 Contribución

1. Haga un fork del repositorio
2. Cree una rama de características (git checkout -b feature/amazing-feature)
3. Haga commit de sus cambios (git commit -m 'feat: amazing new feature')
4. Haga push de su rama (git push origin feature/amazing-feature)
5. Cree un Pull Request

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT.

🔗 Enlaces

• Documentación de la API de FonParam
• Model Context Protocol
• Claude Desktop

⚠️ Nota

Este servidor utiliza la capa gratuita de la API de FonParam y está sujeto a reglas de limitación de velocidad:

• Máximo de 25 solicitudes en 15 minutos
• Máximo de 100 solicitudes por día

Puede considerar obtener una clave de API para uso intensivo.