使用说明

NowCapital.ca退休计划MCP服务器

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

这是什么？

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

您可以做什么：

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

可用工具（技能）

此服务器提供以下技能：

技能/工具	描述
计算_可持续_支出	“我能花多少钱？”的主要工具计算每月的税后预算。
计算_支出_计划	按年返回收入、税款和账户余额的CSV细分。
计算目标支出	计算特定目标月度支出的逐年现金流。如果不可持续，允许余额变为负值，显示短缺。
start_monte-carlo模拟	启动投资组合寿命的风险分析工作。
get_monte_carlo结果	蒙特卡洛作业完成后检索其结果。

特性

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

先决条件

必修的：

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

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

Python安装（uv自动管理）

获取API密钥

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

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-手动下载：

访问https://github.com/XmeleeLabs/mcp-server-nowcapital
点击“代码”→ “下载ZIP”
提取到您会记得的位置（例如。， 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：验证安装

完全重新启动克劳德桌面 （退出并重新打开，不要只是关闭窗口）
检查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 want to retire at 65 with $750,000 saved and spend exactly $4,000/month after tax. Show me my year-by-year cash flows and tell me if my savings will run out.

风险分析（高级功能）：

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进程：

窗户：

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

雨衣：

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

Linux：

pkill -f claude
# Then restart Claude Desktop

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

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

如果仍然不工作：

验证配置文件位置 -确保您编辑了正确的文件
- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
- 窗户： %APPDATA%\Claude\claude_desktop_config.json
检查JSON语法 -使用JSON验证器（jsonline.com）验证您的配置
- 常见问题：Windows路径中缺少逗号、尾随逗号、无转义反斜杠
验证路径 -确保路径 server.py 是正确和绝对的
- Windows：使用其中之一 C:\\path\\to\\file 或 C:/path/to/file
- 测试路径：尝试直接打开文件以确认其存在
检查克劳德桌面日志 对于特定的错误消息：
- 雨衣： ~/Library/Logs/Claude/
- 窗户： %APPDATA%\Claude\logs\
- 查找最新的日志文件，并搜索“nowcapital”或“error”

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

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

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

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

这些是 高级功能 需要高级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

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

隐私和安全

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

许可证

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

使用说明

NowCapital.ca退休计划MCP服务器

这是什么？

可用工具（技能）

特性

先决条件

获取API密钥

安装

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

第一步：安装uv

步骤2：下载服务器代码

步骤3：配置Claude桌面

步骤4：验证安装

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

步骤1：克隆和设置

步骤2：配置Claude桌面

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

示例用法

故障排除

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

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

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

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

Windows上的路径问题

高级：HTTP服务器模式

Gemini CLI配置

任何LLM配置

支持与社区

隐私和安全

许可证

相关 MCP

直布罗陀企业税务工具

Stripe税务发票API服务

量化分析工具

公共服务数据协议服务

金融风险分析服务

8面骰概率计算器