calculator-investment
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@calculator-investmentWhat is the ROI on 100 shares bought at $50 and sold at $75?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Financial calculators over MCP: compound interest, FIRE, historical returns, deep links, 6 languages
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 gradedqualityBmaintenanceEnables arithmetic operations and calculations through natural language, serving as a learning template for NitroStack.MIT