财务规划师MCP服务器
@mohanputti/财务规划师mcp
一种模型上下文协议（MCP）服务器，使用 Scribbox经过验证的财务规划算法该服务器使AI助手能够帮助用户计算SIP需求、投资规划和目标实现策略。
特性
- 🎯 基于目标的财务规划：计算特定财务目标的确切SIP要求
- 📊 由Scribbox提供技术支持：使用Scribbox久经考验的财务规划引擎和算法
- 💡 AI友好：简单直观的界面，针对AI助手交互进行了优化
- 🔄 实时计算：获取即时财务预测和投资策略
- 📈 综合分析：所需投资、未来价值和目标时间表的详细细分
运作原理
这台MCP服务器是人工智能助理和Scrippox的API财务规划之间的桥梁(https://invest.scripbox.com/api/possibility/new).它使用Scribbox的复杂算法将简单的用户输入转换为全面的财务计划。
用法
使用克劳德代码
步骤1：全局安装
npm install -g @mohanputti/financial-planner-mcp步骤2：找到二进制路径
which financial-planner-mcp步骤3：使用完整路径添加到Claude代码
claude mcp add financial-planner --scope user -- /full/path/to/financial-planner-mcp例如，如果使用nvm：
claude mcp add financial-planner --scope user -- ~/.nvm/versions/node/$(node -v)/bin/financial-planner-mcp使用克劳德桌面/光标/鼠标/其他MCP客户端
步骤1：全局安装
npm install -g @mohanputti/financial-planner-mcp步骤2：找到二进制路径
which financial-planner-mcp步骤3：添加到MCP配置 （例如。 claude_desktop_config.json):
{
"mcpServers": {
"financial-planner": {
"command": "/full/path/to/financial-planner-mcp"
}
}
}重要：始终使用 完全绝对路径 二进制（输出which financial-planner-mcp).使用npx或者裸二进制名称可能会导致“连接失败”错误，因为MCP客户端可能不会继承shell的PATH（特别是使用nvm），以及npx在包解析期间写入stdout，这会中断JSON-RPC握手。
本地开发
# Clone and setup
git clone
cd financial-planner-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode
npm run dev可用工具🛠️
financial_planner
使用Scribbox经过验证的算法将财务目标转化为可操作的投资策略。
输入参数：
goals（数组，必填）：财务目标列表，每个目标都有：
- goal_name （string）：目标名称（例如，“儿童教育”、“退休”） - amount （数字）：目标金额（印度卢比） - date （string）：需要目标金额的年份（YYYY格式，例如“2035”）
current_wealth（数组，可选）：现有投资，每个投资都有：
- instrument_type （string）：例如，“共同基金”、“股票”（默认值：“当前财富”） - amount （数字）：当前值，单位为印度卢比 - growth_rate （数字）：预期回报为十进制，例如12%为0.12 - lockin_date （字符串，可选）：锁定YYYY-MM-DD格式的日期
current_monthly_savings（阵列，可选）：持续的SIP/节省，每个都有：
- instrument_type （字符串）：例如，“SIP”、“PF”、“NPS”（默认值：“当前储蓄”） - amount （数字）：每月金额（印度卢比） - growth_rate （number）：预期返回值为十进制 - lockin_date （字符串，可选）：锁定YYYY-MM-DD格式的日期
inflation_rate（可选）：预期通货膨胀率为小数，例如，6%为0.06（默认值：0.06）investment_start_date（可选）：何时开始投资YYYY-MM-DD格式（默认为今天）
AI助手使用示例：
*“我想救₹20 到2030年6月，我将为孩子的教育拨款10万卢比。我目前有₹2 投资10万，可以节省₹15,000每月。假设通货膨胀率为6%，回报率为12%。"*
你会得到什么：
该工具返回全面的财务规划数据，包括：
- 💰 每月所需SIP：您每月需要投资的确切金额
- 📈 未来价值预测：随着时间的推移，你的投资将如何增长
- ⏰ 投资时间表：开始日期、结束日期和关键里程碑
- 📊 短缺分析：你的目标和当前轨迹之间的差距
- 🏦 投资组合细分：不同的来源如何为你的目标做出贡献
- 🎯 多种投资方案：现值、未来价值和投资结束计算
示例响应结构：
{
"monthly_investment": 83400,
"computed_sip_investment": 83333.33,
"total_goal_amount": 2000000,
"investment_start_date": "2025-08-13",
"investment_end_date": "2030-05-01",
"total_shortfall_amount": 1800000,
"computed_monthly_investment_future": 85234.56,
"current_portfolio_contribution": {
"amount": 200000,
"return_rate": 0.12
}
}由Scribbox提供技术支持🚀
此MCP服务器利用 Scrippox的财务规划API，为印度数千名投资者使用的屡获殊荣的财务规划平台提供动力。这些算法考虑了以下因素：
- 通货膨胀影响：自动调整未来货币价值
- 市场波动：现实的回报假设和风险建模
- 目标优先级：针对多个目标的智能分配策略
- 税收效率：优化投资结构
- 弹性规划：处理各种投资场景和时间表
与AI的对话示例
用户: *“帮我计划买一套价值₹1 5年内赚1000亿美元。我有₹10 10万储蓄，可以投资₹25,000每月。"*
AI响应: *“我将使用财务规划师帮助您为购房目标制定财务计划。让我计算最佳投资策略……”*
用户: *“如果我只能救₹20,000每月？"*
AI响应: *“让我用减少的每月投资重新计算你的财务计划……”*
技术细节
- API端点：使用Scribbox的
/api/possibility/new端点 - 协议：模型上下文协议（MCP）1.0
- 运输：STDIO（未来支持SSE/HTTP）
- 验证：使用Zod模式进行完整的输入/输出验证
- 错误处理：全面的错误处理和用户友好的消息
使用的API端点
POST https://invest.scripbox.com/api/possibility/new-Scribbox的财务计划计算引擎
路线图🛣️
第一阶段 （当前）：财务规划
- ✅ 基于目标的SIP计算
- ✅ 投资时间表规划
- ✅ 短缺分析
贡献
该项目旨在通过人工智能辅助规划帮助人们做出更好的财务决策。欢迎投稿！
许可证
MIT许可证-您可以将其用于个人或商业项目。
______________________________________________________________________
*内置于❤️ 对于财务规划界来说。由Scribbox经过验证的算法提供支持。*