MCP Server Nowcapital

NowCapital.ca退休计划MCP服务器

A. 模型上下文协议（MCP） 将Claude等人工智能助手连接到 NowCapital.ca退休计划API这种集成使复杂的加拿大退休模拟具有精确的税收计算、政府福利建模（CPP/OAS）和全面的寿命规划。

这是什么？

此MCP服务器充当AI助手和NowCapital.ca的退休计划引擎之间的桥梁。安装后，您可以与Claude就退休计划进行自然对话，Claude将自动使用这些工具提供准确的加拿大退休预测。

您可以做什么：

• 根据您的储蓄计算可持续的退休支出
• 生成详细的逐年现金流预测
• 运行蒙特卡洛模拟以评估退休计划风险
• 优化RRSP、TFSA和非注册账户的税务策略
• 具有收入分割和配偶福利的模型夫妻场景

特性

• 精确数学：使用详细的税务建模计算可持续的月度支出
• 智能默认值：将简单的输入（“我有50万美元”）转化为税收优化的账户分配
• 情侣支持：自动优化配偶收入分配和幸存者计划
• 高级场景：支持支出阶段（Go Go、Slow Go、No Go）、固定收益养老金、LIRA和自定义分配策略

先决条件

必修的：

• Claude Desktop应用程序（或另一个兼容MCP的AI客户端）
• A NowCapital.ca API密钥(见下文)

不需要（如果使用快速启动方法）：

• Python安装（uv自动管理）

获取API密钥

1. 网络：参观 现在Capital.ca
2. 移动：从安装 Google Play商店
3. 引导到 API访问 生成API密钥
4. 复制密钥-您需要它进行配置

API密钥类型：

• 演示/免费密钥：包括基本退休计算（可持续支出、详细预测）
• 高级密钥：解锁高级功能：

- 蒙特卡洛模拟（风险分析） - 额外收入事件（一次性意外收入、兼职工作等） - 自定义支出阶段（Go Go、Slow Go、No Go支出模式）

需要帮助？ 联系support@nowcapital.ca

安装

选择 一 以下两种方法：

方法1：紫外线快速入门（推荐）

为什么是紫外线？ uv是一个快速的Python包管理器，可以自动处理Python安装和依赖关系。你不需要事先安装Python——uv会处理一切。

第一步：安装uv

Windows（PowerShell）：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Mac/Linux（终端）：

curl -LsSf https://astral.sh/uv/install.sh | sh

步骤2：下载服务器代码

选项A-使用git：

git clone https://github.com/XmeleeLabs/mcp-server-nowcapital.git

选项B-手动下载：

1. 访问https://github.com/XmeleeLabs/mcp-server-nowcapital
2. 点击“代码”→ “下载ZIP”
3. 提取到您会记得的位置（例如。， C:\Projects\ 或 ~/Projects/)

重要提示： 请注意保存代码的完整路径——下一步您将需要它。

步骤3：配置Claude桌面

您需要通过编辑配置文件来告诉Claude Desktop在哪里可以找到此服务器。

找到您的配置文件：

• 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

查找文件的提示：

• 在Windows上：按 Win+R，类型 %APPDATA%\Claude，按Enter键
• 在Mac上：在Finder中，按 Cmd+Shift+G，粘贴上面的路径
• 如果文件不存在，请将其创建为空JSON文件： {}

添加此配置 （替换占位符）：

对于Windows：

{
  "mcpServers": {
    "nowcapital-retirement": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "requests",
        "python",
        "C:\\Users\\YourName\\mcp-server-nowcapital\\server.py"
      ],
      "env": {
        "NOWCAPITAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

对于Mac/Linux：

{
  "mcpServers": {
    "nowcapital-retirement": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "requests",
        "python",
        "/Users/YourName/mcp-server-nowcapital/server.py"
      ],
      "env": {
        "NOWCAPITAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

配置说明：

• 将路径替换为 绝对路径 到你救的地方 server.py
• Windows路径使用双反斜杠(\\)或正斜杠(/)
• 替换 your_api_key_here 使用您的实际NowCapital.ca API密钥
• 如果该文件已经有其他MCP服务器，请在 mcpServers 对象

步骤4：验证安装

1. 完全重新启动克劳德桌面 （退出并重新打开，不要只是关闭窗口）
2. 检查MCP服务器状态：

- 单击左下角的个人资料图标 - 选择 设置 → 开发者 - 寻找“nowcapital retirement”-它应该显示为 “正在运行” - 如果您看到“错误”或未列出，请检查 故障排除 章节

使用以下提示进行测试：

I'm 60 years old with $800,000 in retirement savings. 
How much can I safely spend per month in retirement?

克劳德应该自动使用退休计划工具来提供详细的计算，包括税收影响和政府福利。

______________________________________________________________________

方法2：手动安装（高级）

如果您喜欢手动控制或已经熟悉Python开发，请使用此方法。

要求：

• Python 3.10或更高版本
• git（可选，用于克隆）

步骤1：克隆和设置

Windows（PowerShell）：

git clone https://github.com/XmeleeLabs/mcp-server-nowcapital.git
cd mcp-server-nowcapital
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

Mac/Linux（终端）：

git clone https://github.com/XmeleeLabs/mcp-server-nowcapital.git
cd mcp-server-nowcapital
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

步骤2：配置Claude桌面

编辑您的 claude_desktop_config.json （以上位置）并添加：

窗户：

{
  "mcpServers": {
    "nowcapital-retirement": {
      "command": "C:\\Users\\YourName\\mcp-server-nowcapital\\venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\YourName\\mcp-server-nowcapital\\server.py"
      ],
      "env": {
        "NOWCAPITAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Mac/Linux：

{
  "mcpServers": {
    "nowcapital-retirement": {
      "command": "/Users/YourName/mcp-server-nowcapital/venv/bin/python",
      "args": [
        "/Users/YourName/mcp-server-nowcapital/server.py"
      ],
      "env": {
        "NOWCAPITAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

用实际安装位置替换这两个路径，并添加API密钥。

步骤3：测试服务器（可选）

在使用Claude之前，您可以直接测试服务器：

窗户：

$env:NOWCAPITAL_API_KEY="your_api_key_here"
fastmcp dev server.py

Mac/Linux：

export NOWCAPITAL_API_KEY="your_api_key_here"
fastmcp dev server.py

这将在浏览器中打开一个测试界面，您可以在其中验证工具是否正常工作。

______________________________________________________________________

示例用法

安装后，您可以自然地向Claude提问。Claude将自动确定使用哪些工具，您不需要指定工具名称。

简单的支出计算：

I'm 55 with $600,000 saved. What's my maximum safe monthly retirement spending?

详细预测：

Show me a year-by-year retirement plan for someone who is 60 with $800,000 
in savings, planning to retire at 65.

风险分析（高级功能）：

I'm 65, have $850,000 saved, and plan to spend $4,500/month. 
What are the chances my money will last through retirement?

*注：蒙特卡洛模拟需要高级API密钥，需要5-15秒才能完成。*

高级场景（高级功能）：

I'm 62 with $1M saved. Model my retirement with these phases:
- First 10 years: spending $5,000/month (active travel years)
- Next 10 years: reduce spending by 2% annually (slowing down)
- Remaining years: reduce by another 2% annually (staying home more)
Also, I'll receive a $50,000 inheritance at age 70.

*注：费用阶段和额外收入事件需要高级API密钥。*

探索选项：

What retirement planning parameters can I customize in my calculations?

默认假设：

• 蒙特卡洛模拟使用加拿大FP基线假设：

- 4.5%的预期回报 - 2.3%的通货膨胀率（CPI） - 9%的回报波动率 - 通胀波动率1.2% - -0.05回报与通货膨胀之间的相关性

故障排除

服务器显示“错误”状态或未列出

首先，尝试完全重新启动：

Claude Desktop有时会在您关闭窗口后仍保持后台进程运行。您需要完全终止所有Claude进程：

窗户：

1. 按 Ctrl+Shift+Esc 打开任务管理器
2. 在列表中查找任何“Claude”进程
3. 右键单击每个任务，然后选择“结束任务”
4. 重新启动克劳德桌面

雨衣：

1. 按 Cmd+Space，键入“活动监视器”，按Enter键
2. 在进程列表中搜索“Claude”
3. 选择每个Claude进程并单击ⓧ 按钮（强制退出）
4. 重新启动克劳德桌面

Linux：

pkill -f claude
# Then restart Claude Desktop

杀死所有进程并重新启动后，检查状态：

• 点击您的个人资料（左下角）→ 设置→ 开发者
• 寻找“nowcapital退休”-它应该显示“跑步”

如果仍然不工作：

1. 验证配置文件位置 -确保您编辑了正确的文件

- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 检查JSON语法 -使用JSON验证器（jsonline.com）验证您的配置

- 常见问题：Windows路径中缺少逗号、尾随逗号、无转义反斜杠

1. 验证路径 -确保路径 server.py 是正确和绝对的

- Windows：使用其中之一 C:\\path\\to\\file 或 C:/path/to/file - 测试路径：尝试直接打开文件以确认其存在

1. 检查克劳德桌面日志 对于特定的错误消息：

- 雨衣： ~/Library/Logs/Claude/ - 窗户： %APPDATA%\Claude\logs\ - 查找最新的日志文件，并搜索“nowcapital”或“error”

克劳德说它无法访问这些工具

1. 验证您的API密钥 -登录NowCapital.ca以验证密钥（API访问）
2. 检查您的互联网连接 -服务器需要访问api.nowcapital.ca
3. 重新启动克劳德桌面 -完全退出并重新打开应用程序

“功能不可用”或高级功能错误

如果您看到有关蒙特卡洛模拟、支出阶段或其他收入事件的错误：

• 这些是 高级功能 需要高级API密钥
• 演示/免费密钥仅支持基本计算（可持续支出和详细预测）
• 升级API密钥，网址为 现在Capital.ca 要解锁这些功能

“找不到模块”错误（手动安装）

请确保在运行之前激活了虚拟环境：

• 窗户： .\venv\Scripts\Activate.ps1
• Mac/Linux： source venv/bin/activate

Windows上的路径问题

如果您的路径有空格，请确保整个路径在JSON中正确转义。考虑将服务器移动到没有空格的路径（例如。， C:\Projects\).

高级：HTTP服务器模式

为了与Gemini或AnythingLLM等其他AI客户端集成，您可以通过HTTP模式访问NowCapital.ca MCP服务器。

Gemini CLI配置

编辑您的Gemini设置文件：

• Mac/Linux： ~/.gemini/settings.json
• 窗户： %USERPROFILE%\.gemini\settings.json

添加：

{
  "mcpServers": {
    "nowcapital-retirement": {
      "httpUrl": "https://mcp.nowcapital.ca/mcp",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

任何LLM配置

{
  "mcpServers": {
    "nowcapital-retirement": {
      "type": "streamable",
      "url": "https://mcp.nowcapital.ca/mcp"
    }
  }
}

对于Gemini和AnythingLLM，请在请求头中包含您的API密钥，或在提示中提供API密钥。

支持与社区

需要帮助？

• 📧 电子邮件：support@nowcapital.ca
• 🎥 油管 @现在资本ca
• 📘 脸书 NowCapital
• 📷 Instagram： @nowcapital.ca

发现错误或有功能请求？ 打开一个问题

隐私和安全

• 您的API密钥存储在本地的Claude配置文件中
• 退休计算在NowCapital.ca服务器上执行
• 此MCP服务器不存储任何财务数据
• 所有通信都使用HTTPS加密

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。