Skip to main content
Glama
deenesjakoruzh
Sean-Bravo

taxformatter-mcp-server

by Sean-Bravo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

📊 TaxFormatter

将加密货币 CSV 和银行对账单 PDF 解析为税务就绪数据。

REST API · MCP 服务器 · Node SDK · Python SDK · 用户仪表板

API MCP Node SDK License

🚀 功能概述

TaxFormatter 将杂乱的财务导出文件转换为结构化、税务就绪的数据——既适用于人类，也适用于 AI 代理。

上传 Coinbase 的 CSV、Kraken 的 ZIP、Binance 的 .tar.gz 或 Chase 的 PDF 对账单，即可获得干净、标准化的交易集，您可以将其导入 Koinly、TurboTax、CoinLedger、ZenLedger，或直接导入您自己的软件中。

   Exchange CSV                        Clean, normalized
   Bank PDF              →             transactions (JSON / CSV)
   XLSX / ZIP / TAR.GZ                 + AI-generated insights

Related MCP server: document-to-json-mcp

✨ 特性

🔌 开发者 REST API

在一下午的时间内为您的产品添加加密税务或银行数据导入功能。

  • POST /v1/parse — 上传 CSV 或 PDF，获取结构化 JSON

  • GET /v1/sources — 列出所有支持的交易所、银行和输出格式

  • GET /v1/usage — 每月配额、RPM 限制、当前消耗量

  • GET /v1/health — 存活探针

  • 认证： X-API-Key 请求头，使用 tf_live_* 密钥（静态存储时进行 SHA-256 哈希处理）

  • 主机： https://api.taxformatter.com

🤖 AI 代理的 MCP 服务器

让 Claude、Cursor、Windsurf 或任何兼容 MCP 的代理能够直接解析加密货币和银行数据。

npx @taxformatter/mcp-server

工具

功能

parse_crypto_csv

自动检测交易所，返回标准化交易

parse_bank_statement

从银行对账单 PDF 中提取交易

list_supported_sources

查询所有支持的来源和输出格式

📦 官方 SDK

🏦 14 家交易所 · 7 家以上银行 · 4 种税务软件格式

交易所： Coinbase · Kraken · Gemini · Binance · Robinhood · Crypto.com · PayPal · Cash App · Venmo · KuCoin · Bybit · FTX · Bitfinex · OKX

银行： Chase · Mercury · Navy Federal · Bank of America · Wells Fargo · Citi · Capital One

导出格式： Koinly · TurboTax (Form 8949) · CoinLedger · ZenLedger

🧠 分层 AI 洞察

每个解析后的文件都会附带可操作的分析——根据您的计划进行扩展。

层级

模型

输出

免费

Gemini 1.5 Flash

快速统计 + 基础标记

专业

Claude Sonnet 4

平衡分析，详细拆解

高级

Claude Opus 4

深度分析 + 税务建议

🖥️ 用户仪表板

不是开发者？taxformatter.com 上的 Web 应用提供完整的拖放体验，具有实时任务状态、交易所自动检测、转换预览和一键下载功能。

🏗️ 技术栈

层级

技术

前端

Next.js 16 · React 19 · TypeScript · Tailwind v4

认证

NextAuth (Google OAuth + 邮箱/密码 + 2FA)

数据库

Neon (无服务器 PostgreSQL)

存储

AWS S3 (预签名 URL)

队列

AWS SQS + DLQ

计算

AWS Lambda × 4 (扫描器、处理器、Webhook、API)

边缘

AWS API Gateway + WAF + CloudFront

支付

Stripe (消费者 + 开发者层级)

邮件

AWS SES / Nodemailer

监控

Sentry + CloudWatch

IaC

Terraform

📁 仓库布局

trw/
├── app/                 # Next.js App Router (marketing, dashboard, /v1 admin)
│   ├── api/             # Internal API routes (NextAuth, uploads, jobs, dev keys)
│   ├── dashboard/       # Authenticated user area + /dashboard/developer
│   ├── docs/            # MDX-powered docs site
│   └── upload/          # Anonymous bank statement → CSV landing page
│
├── backend/             # Python processing layer (AWS Lambda)
│   ├── handlers/        # scanner · processor · webhook · api
│   ├── services/
│   │   ├── engine.py            # CSV parsing (14 exchange parsers)
│   │   ├── format_converter.py  # Koinly → TurboTax/CoinLedger/ZenLedger
│   │   ├── fingerprinting.py    # Exchange auto-detection
│   │   ├── ai_insights.py       # Tiered AI analysis
│   │   ├── api_auth.py          # API key validation + rate limiting
│   │   └── bank_statement/      # PDF extraction pipeline
│   ├── configs/banks/*.yaml     # YAML-driven bank configs
│   └── terraform/               # Infra as code
│
├── packages/
│   ├── mcp-server/      # @taxformatter/mcp-server (npm)
│   ├── sdk-node/        # @taxformatter/sdk (npm)
│   └── sdk-python/      # taxformatter (PyPI)
│
├── components/          # React components (marketing, dashboard, ui)
├── lib/                 # Business logic (auth, api-keys, stripe, email)
├── db/                  # PostgreSQL schema + migrations
└── docs/                # Setup guides

完整架构参考：ARCHITECTURE.md

⚡ 快速开始

运行 Web 应用

npm install
npm run dev

打开 http://localhost:3000。

尝试 API

curl -X POST https://api.taxformatter.com/v1/parse \
  -H "X-API-Key: tf_live_..." \
  -F "file=@coinbase.csv"

将 MCP 服务器与 Claude Code 一起使用

{
  "mcpServers": {
    "taxformatter": {
      "command": "npx",
      "args": ["@taxformatter/mcp-server"],
      "env": { "TAXFORMATTER_API_KEY": "tf_live_..." }
    }
  }
}

安装 Node SDK

npm install @taxformatter/sdk
import { TaxFormatter } from "@taxformatter/sdk";

const tf = new TaxFormatter({ apiKey: process.env.TF_API_KEY! });
const result = await tf.parse({ file: fs.createReadStream("./coinbase.csv") });

🧪 测试

npm test              # Jest unit tests (160+ across API, MCP, keys, UI)
npm run test:e2e      # Playwright end-to-end tests
npm run typecheck     # TypeScript strict mode
npm run lint          # ESLint

💳 定价

消费者（仪表板）

层级

价格

亮点

免费

$0

每月 3 次下载 · Gemini 洞察

专业

$89/年

无限制 · Claude Sonnet 洞察

高级

$189/年

全部功能 + Claude Opus + 优先支持

开发者（API）

层级

价格

配额

RPM

入门

$29/月

100 个文件

30

成长

$99/月

500 个文件

60

商业

$249/月

2,000 个文件

120

🔒 安全亮点

  • 无状态 API 处理 — 文件内容仅存在于 Lambda 内存中，从不写入磁盘

  • 零负载日志记录 — api_requests 仅存储元数据（哈希、状态、字节数、耗时）

  • API 密钥 静态存储时进行 SHA-256 哈希处理，前缀为 tf_live_ 以便识别

  • TLS 1.3 在所有地方强制执行

  • AES-256 对所有存储的上传文件进行加密

  • AWS WAF — DDoS 防护、SQL 注入、XSS 缓解

  • 用户可控保留 — 默认 1 年，或下载后删除

完整披露请见 taxformatter.com/security。

📚 文档

许可证

私有 — Quantum Transfer Group。保留所有权利。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers