@kimagure-dd/xirr-mcp

用于 XIRR（扩展内部收益率） 计算的 MCP 服务器，内置对乐天证券 (Rakuten Securities) 交易 CSV 的支持。

将其接入 Claude Desktop 或 Claude Code，提供从券商导出的 CSV，然后询问：

「这个 CSV 和当前评估价值 ¥1,500,000，请计算实际年化收益率」

Claude 将为您计算 XIRR（考虑不规则的投入和提取），并解释结果。

功能

• 🧮 calculate_xirr — 根据任意现金流序列 + 当前估值计算 XIRR

• 📄 parse_rakuten_csv — 将乐天证券交易 CSV (取引履歴) 解析为标准化的现金流

• 🔌 纯 stdio MCP 服务器，无需网络访问

• 📦 无需运行时配置，单个 npx 命令即可运行

安装与设置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "xirr": {
      "command": "npx",
      "args": ["-y", "@kimagure-dd/xirr-mcp"]
    }
  }
}

重启 Claude Desktop。calculate_xirr 和 parse_rakuten_csv 工具应该会出现。

Claude Code

claude mcp add xirr -- npx -y @kimagure-dd/xirr-mcp

使用示例

直接计算

询问 Claude：

「请根据以下现金流计算 XIRR。2020-01-01 投资 100 万日元，2022-01-01 追加 50 万日元，当前（2025-01-01）评估价值 200 万日元」

Claude 将使用结构化输入调用 calculate_xirr 并返回：

{
  "annualRate": 12.34,
  "annualRateFormatted": "12.34%",
  "totalInvestment": 1500000,
  "totalGain": 500000,
  "gainRateFormatted": "33.33%",
  "converged": true
}

使用乐天证券 CSV

1. 登录乐天证券 → 取引履歴 → CSV 下载

2. (由于下载的是 Shift_JIS 编码，请转换为 UTF-8)

3. 将文件内容传给 Claude 并要求：“请根据此计算实际年化收益率。当前评估价值为 ¥X”

Claude 将自动通过 parse_rakuten_csv → calculate_xirr 处理 CSV。

工具参考

calculate_xirr

根据一系列带日期的现金流和当前估值计算 XIRR。

输入：

输出：

parse_rakuten_csv

解析乐天证券交易 CSV。

输入：

必需的 CSV 表头：

约定日, 取引, ファンド名, 受渡金額/(ポイント利用)[円]

行为：

• 买付 行 → 正数金额（投资）

• 其他交易类型（例如 売却） → 负数金额（提取）

• 无效行将被跳过并发出警告

计算方法

• 牛顿-拉夫逊 (Newton-Raphson) 迭代作为主要求解器

• 当牛顿法无法收敛时使用二分法作为备选

• 时间单位：月（使用每月 365.25 / 12 天）

• 收敛阈值：1e-7

该逻辑与 kimagure-dd.dev 上的基于浏览器的 XIRR 计算器 使用的逻辑相同，因此结果一致。

免责声明

此工具仅用于计算投资绩效，仅供参考。 未考虑税收、交易费用和货币兑换。 输出不构成投资建议。

开发

npm install
npm run build
npm test

在发布前在本地测试服务器：

npm pack
# Then point Claude Desktop to the .tgz path

许可证

MIT © kimagure-dd

相关

• 🌐 kimagure-dd.dev — 基于浏览器的金融计算器

• 📊 XIRR 计算器（网页版）

• 🐙 源代码