AI导哈

Kraken投资组合跟踪器

为德国Kraken交易者提供的投资组合跟踪和税务工具，连接Kraken期货和现货API，计算FIFO成本基础并提供税务报告。

  • by Nabil-MEDIOUNI
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Nabil-MEDIOUNI/kraken-portfolio-mcp

使用说明

海怪投资组合

德国Kraken日内交易者的投资组合跟踪器和税务工具。连接Kraken Futures和Spot API，计算FIFO成本基础，并告诉您是否欠税。

你得到了什么

仪表盘 在 http://localhost:8000 与：

  • 期货和现货账户的现金余额
  • 税务概述，包括申报状态（单身/已婚）和免税额计算
  • 期货损益和现货损益摘要
  • 将交易历史与源过滤、日期范围和分页合并
  • 使用排序、侧边过滤（长/短）和源过滤定位表
  • 所有内容均可按年过滤，可通过URL共享

MCP服务器 AI助手（Claude Code、Cursor、Codex）查询您的投资组合并生成税务报告。

REST API 用于程序化访问您的所有Kraken数据。

快速启动

git clone <repo-url> && cd kraken-portfolio-mcp
npm install

创建 .env:

KRAKEN_FUTURES_PUBLIC_KEY=your_key
KRAKEN_FUTURES_PRIVATE_KEY=your_key
KRAKEN_SPOT_API_KEY=your_key
KRAKEN_SPOT_API_SECRET=your_key

运行：

npm run dev     # dashboard with auto-reload
npm start       # production
npm run mcp     # MCP server for AI assistants

打开 http://localhost:8000 然后点击同步。

税务申报

为德国税法而建。仪表板显示每年的实时税务概览。有关详细报告，请咨询您的AI助手：

生成我的2025年德国加密货币税务报告

MCP工具处理一切：

  • 即期交易 先进先出成本法，1年持有期检查，运费（1000欧元）
  • 保证金头寸 损益分类为私人销售
  • 期货 已实现损益+融资费用、备用备用轨道（1000/2000欧元）、20000损失上限
  • 质押 按公平市场价值欧元奖励，256欧元Freigrenze

返回Elster行引用和WISO Steuer或Taxfix的CSV。

API

期货

端点 返回
GET /futures/balances Flex+现金账户余额
GET /futures/positions 损益表的平仓历史
GET /futures/transactions 已实现损益、融资费用、转账

斑点

端点 返回
GET /spots/balances 所有非零余额
GET /spots/positions 损益结算保证金头寸
GET /spots/transactions 基于FIFO成本的完整历史记录

其他

端点 返回
GET / 仪表板
GET /sync SSE流用于完全数据同步
GET /health 服务器状态

MCP设置

添加到您的AI客户端配置中：

{
  "mcpServers": {
    "kraken-portfolio": {
      "command": "npx",
      "args": ["tsx", "/path/to/kraken-portfolio-mcp/src/mcp-server.ts"],
      "env": {
        "KRAKEN_FUTURES_PUBLIC_KEY": "...",
        "KRAKEN_FUTURES_PRIVATE_KEY": "...",
        "KRAKEN_SPOT_API_KEY": "...",
        "KRAKEN_SPOT_API_SECRET": "..."
      }
    }
  }
}

可用工具

工具 它做什么
kraken_tracker_futures_balances 期货账户余额
kraken_tracker_futures_positions 已平仓期货头寸
kraken_tracker_futures_transactions 期货交易历史
kraken_tracker_spot_balances 即期余额
kraken_tracker_spot_positions 现货保证金头寸
kraken_tracker_spot_transactions FIFO现货交易
kraken_tracker_portfolio_summary 组合投资组合概述
kraken_tracker_german_tax_report CSV格式的完整德国税务报告

科技

  • TypeScript+Express
  • 用于AI工具集成的MCP SDK
  • 基于成本的FIFO批次跟踪
  • 服务器发送实时同步事件
  • CoinGecko API加密图标
  • 无前端框架，单一自包含的HTML页面

相关 MCP