Skip to main content
Glama
Respawn84

calculator-investment

by Respawn84

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.

Related MCP Connectors

  • Loan & mortgage calculator, compound interest, ROI, crypto prices, FX conversion for AI agents.

  • 90+ pure finance calculators: loans, investing, bonds, options, tax. Stateless, stores nothing.

  • SmartMoney77 MCP v0.6.0 — 14 public tools that turn financial questions into exact numbers and citable links. New: historical_investment_return and compare_investments, which compute "what if I had invested" results from real yearly price data. Also compound interest, FIRE number, credit-card payoff, emergency fund, inflation, latte factor, investment fees, cost of waiting, plus discovery/deep-link/share-pack tools for a catalog of calculators in 6 languages (he/en/ar/es/pt/in). Public, no login. Endpoint: https://smartmoney77.com/mcp

  • Financial calculators over MCP: compound interest, FIRE, historical returns, deep links, 6 languages

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables mathematical calculations through basic arithmetic operations including addition, subtraction, multiplication, division, exponentiation, and logarithms. Provides a simple interface for AI agents to perform mathematical computations.
    6
    3
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to perform accurate mathematical calculations by evaluating expressions using mathjs. Supports basic arithmetic, functions, constants, and complex mathematical operations through natural language requests.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables financial calculations such as compound interest, loan EMI, and savings goal projections through natural language.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables arithmetic operations and calculations through natural language, serving as a learning template for NitroStack.
    MIT