calculator-investment
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 |
| Suma múltiples valores |
|
| Resta valores en orden |
|
| Multiplica múltiples valores |
|
| Divide valores en orden |
|
| Calcula potencia |
|
| Raíz cuadrada |
|
| Porcentaje de un valor |
|
| Cambio porcentual |
|
| Retorno de inversión |
|
| Coste medio de acciones |
|
| Valor total de cartera |
|
| Cuota mensual de préstamo |
|
| Coste total del préstamo |
|
| Ahorro por amortización |
|
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:
Haz fork del proyecto
Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad)Commit tus cambios (
git commit -m 'Añadir nueva funcionalidad')Push a la rama (
git push origin feature/nueva-funcionalidad)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 deployed
Maintenance
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
Free investment and startup math, guide search and prompts: IRR, MOIC, SAFE, QSBS, burn multiple.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables 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.63-
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to perform accurate mathematical calculations by evaluating expressions using mathjs. Supports basic arithmetic, functions, constants, and complex mathematical operations through natural language requests.-
- FlicenseNot gradedqualityDmaintenanceEnables financial calculations such as compound interest, loan EMI, and savings goal projections through natural language.-
- AlicenseNot gradedqualityDmaintenanceEnables arithmetic operations and calculations through natural language, serving as a learning template for NitroStack.MIT