Skip to main content
Glama
Respawn84

calculator-investment

by Respawn84
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Calculator Investment MCP Server

Servidor MCP (Model Context Protocol) que proporciona herramientas de cálculo matemático y financiero para análisis de inversiones y préstamos.

🚀 Características

Operaciones Matemáticas Básicas

  • ✅ Suma, resta, multiplicación y división

  • ✅ Potencias y raíces cuadradas

  • ✅ Cálculo de porcentajes

Análisis de Inversiones

  • 📈 Cambio porcentual entre valores

  • 💰 Cálculo de retorno de inversión (ROI)

  • 📊 Coste medio ponderado de acciones

  • 💼 Valoración de cartera de inversiones

Análisis de Préstamos

  • 🏦 Cálculo de cuota mensual

  • 💳 Coste total del préstamo e intereses

  • 🎯 Ahorro por amortización anticipada

Related MCP server: Math MCP Server

📦 Instalación

# Clonar el repositorio
git clone https://github.com/TU-USUARIO/calculator-investment-mcp.git
cd calculator-investment-mcp

# Instalar dependencias
npm install

# Compilar TypeScript
npm run build

⚙️ Configuración

Configuración en Claude Desktop

Añade esto a tu archivo de configuración de Claude (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "calculator-investment": {
      "command": "node",
      "args": ["/ruta/absoluta/a/calculator-investment/build/index.js"]
    }
  }
}

Configuración en otros clientes MCP

Sigue las instrucciones del cliente MCP que estés utilizando para conectar servidores stdio.

📖 Uso

Una vez configurado, el servidor proporciona la herramienta calculate con múltiples operaciones.

Ejemplos de Operaciones Matemáticas

// Suma
{ operation: "add", values: [10, 20, 30] }
// Resultado: "60"

// Potencia
{ operation: "power", values: [2, 8] }
// Resultado: "256"

// Porcentaje (15% de 200)
{ operation: "percentage", values: [200, 15] }
// Resultado: "30"

Ejemplos de Análisis de Inversiones

// Cambio porcentual
{
  operation: "percentage_change",
  details: {
    initial_value: 1000,
    final_value: 1250
  }
}
// Resultado: "25.00"

// Retorno de inversión
{
  operation: "investment_return",
  details: {
    initial_value: 5000,
    shares: 100,
    price_per_share: 55,
    commission_sell: 10
  }
}
/* Resultado:
{
  "initial_cost": "5000.00",
  "current_value": "5500.00",
  "commission_sell": "10.00",
  "net_value": "5490.00",
  "profit": "490.00",
  "profit_percent": "9.80"
}
*/

// Coste medio de acciones
{
  operation: "average_cost",
  details: {
    holdings: [
      { shares: 100, price: 50 },
      { shares: 50, price: 60 },
      { shares: 75, price: 55 }
    ]
  }
}
/* Resultado:
{
  "total_shares": 225,
  "total_cost": "12125.00",
  "average_cost": "53.89"
}
*/

// Valor de cartera
{
  operation: "portfolio_value",
  details: {
    holdings: [
      { shares: 100, price: 52.50 },
      { shares: 50, price: 61.00 }
    ]
  }
}
/* Resultado:
{
  "total_value": "8300.00",
  "positions": [
    { "shares": 100, "price": 52.5, "value": "5250.00" },
    { "shares": 50, "price": 61, "value": "3050.00" }
  ]
}
*/

Ejemplos de Análisis de Préstamos

// Cuota mensual de préstamo
{
  operation: "loan_payment",
  details: {
    principal: 150000,
    annual_rate: 3.5,
    years: 25
  }
}
/* Resultado:
{
  "principal": "150000.00",
  "annual_rate": "3.50",
  "months": 300,
  "monthly_payment": "751.55",
  "total_paid": "225465.00",
  "total_interest": "75465.00"
}
*/

// Ahorro por amortización anticipada
{
  operation: "early_payment_savings",
  details: {
    principal: 150000,
    annual_rate: 3.5,
    years: 25,
    early_payment: 20000,
    early_payment_month: 12
  }
}
/* Resultado:
{
  "original_monthly_payment": "751.55",
  "original_total_interest": "75465.00",
  "early_payment_amount": "20000.00",
  "early_payment_month": 12,
  "new_monthly_payment": "653.35",
  "new_total_interest": "63318.77",
  "interest_savings": "12146.23",
  "percentage_saved": "16.09"
}
*/

🛠️ API Completa

Operaciones Disponibles

Operación

Descripción

Parámetros

add

Suma múltiples valores

values: number[]

subtract

Resta valores en orden

values: number[]

multiply

Multiplica múltiples valores

values: number[]

divide

Divide valores en orden

values: number[]

power

Calcula potencia

values: [base, exponente]

sqrt

Raíz cuadrada

values: [número]

percentage

Porcentaje de un valor

values: [cantidad, porcentaje]

percentage_change

Cambio porcentual

details: {initial_value, final_value}

investment_return

Retorno de inversión

details: {initial_value?, shares, price_per_share, commission_sell?}

average_cost

Coste medio de acciones

details: {holdings: [{shares, price}]}

portfolio_value

Valor total de cartera

details: {holdings: [{shares, price}]}

loan_payment

Cuota mensual de préstamo

details: {principal, annual_rate, years/months}

loan_total_cost

Coste total del préstamo

details: {principal, annual_rate, years/months}

early_payment_savings

Ahorro por amortización

details: {principal, annual_rate, years/months, early_payment, early_payment_month?}

Parámetros de details

  • initial_value: Valor inicial de la inversión

  • final_value: Valor final para calcular cambio

  • shares: Número de acciones

  • price_per_share: Precio por acción

  • commission_buy: Comisión de compra (cantidad fija)

  • commission_sell: Comisión de venta (cantidad fija)

  • holdings: Array de posiciones {shares: number, price: number}

  • principal: Capital del préstamo

  • annual_rate: Tasa anual de interés (TAE) en porcentaje

  • years: Plazo del préstamo en años

  • months: Plazo del préstamo en meses

  • early_payment: Cantidad de amortización anticipada

  • early_payment_month: Mes de la amortización (por defecto: 12)

🔧 Desarrollo

# Instalar dependencias de desarrollo
npm install

# Modo de desarrollo con watch
npm run watch

# Compilar
npm run build

# Ejecutar en modo desarrollo
npm run dev

📋 Scripts Disponibles

{
  "build": "tsc",
  "watch": "tsc --watch",
  "dev": "node build/index.js"
}

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

  1. Haz fork del proyecto

  2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)

  3. Commit tus cambios (git commit -m 'Añadir nueva funcionalidad')

  4. Push a la rama (git push origin feature/nueva-funcionalidad)

  5. Abre un Pull Request

📝 Licencia

Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.

👨‍💻 Autor

Daniel - Instructor de programación y desarrollador

🙏 Agradecimientos

  • Model Context Protocol - Protocolo para integración con modelos de IA

  • Anthropic - Por Claude y el ecosistema MCP

Nota: Este servidor MCP está diseñado para uso personal y educativo. Para cálculos financieros críticos, consulta siempre con un asesor financiero profesional.

This server cannot be installed

F
license - not found
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Respawn84/claude_mcp-server_calculos_basicos_y_financieros'

If you have feedback or need assistance with the MCP directory API, please join our Discord server