项目简介

cgt-tool 是一个专门用于计算英国资本利得税（CGT）的命令行工具，内置MCP服务器功能，允许AI助手直接调用CGT计算能力。

主要功能

解析交易文件：支持CGT DSL格式和JSON格式的交易数据解析
生成税务报告：根据英国HMRC股票匹配规则（同日、B&B、第104条）计算特定纳税年度的收益和损失
匹配规则解释：详细说明每笔销售如何按照HMRC规则匹配到购买记录
汇率查询：获取HMRC每月平均汇率用于外币转换
格式转换：将JSON交易数据转换为DSL格式供CLI使用

安装步骤

Homebrew安装（macOS & Linux）

brew tap velikodniy/tap
brew install cgt-tool

预编译二进制文件

从GitHub Releases页面下载对应平台的二进制文件，然后赋予执行权限并移动到PATH目录。

从源码构建

需要Rust 1.85+环境：

cargo install --path crates/cgt-cli

MCP服务器配置

在Claude Desktop配置文件中添加以下内容：

macOS：'~/Library/Application Support/Claude/claude_desktop_config.json**

{
  "mcpServers": {
    "cgt-tool": {
      "command": "/usr/local/bin/cgt-tool",
      "args": ["mcp"]
    }
  }
}
**Windows**：'%APPDATA%\Claude\claude_desktop_config.json**

配置说明：
- **command**: 指向cgt-tool可执行文件的完整路径
- **args**: 固定参数["mcp"]，用于启动MCP服务器

## 基本使用方法
1. 确保已正确安装cgt-tool
2. 在Claude Desktop中配置MCP服务器
3. 重启Claude Desktop使配置生效
4. 在Claude界面中即可使用CGT计算功能

## 可用工具
- 'parse_transactions'：验证和解析交易数据
- 'calculate_report'：计算特定纳税年度的CGT报告
- 'explain_matching'：解释特定销售如何匹配到购买记录
- 'get_fx_rate'：查询HMRC外汇汇率
- 'convert_to_dsl'：将JSON转换为DSL格式
- 支持同日规则、B&B规则、第104条规则匹配
- 自动将外币转换为GBP进行税务计算

关键词