AI导哈

会计科目映射工具

coa-mapper-mcp 是一个开源的会计科目映射工具，支持在 QuickBooks、Xero、Wave、Sage 和 FreshBooks 等流行的小型企业会计平台之间映射、比较和验证会计科目表。

  • by NaimGQKC
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 NaimGQKC/coa-mapper-mcp

使用说明

coa成像仪mcp

绘制QuickBooks、Xero、Wave、Sage和FreshBooks之间的会计科目表——由MCP提供支持。

coa成像仪mcp 是一个开源 模型上下文协议 该服务器允许AI助手在流行的小型企业会计平台上绘制、比较和验证会计科目表。它附带了五个平台的精心策划的账户数据和一个GAAP参考层，因此映射以标准会计分类为基础。

支持的平台

平台 状态
QuickBooks ✅
Xero ✅
波浪 ✅
圣人 ✅
新书 ✅

快速开始

安装

pip install git+https://github.com/NaimGQKC/coa-mapper-mcp.git

配置Claude桌面

将此添加到您的Claude Desktop MCP配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "coa-mapper": {
      "command": "coa-mapper-mcp"
    }
  }
}

重新启动Claude Desktop，工具将立即可用。

工具

工具 说明
suggest_mapping 为源帐户建议最多3个目标帐户，按置信度排名。
list_accounts 列出平台的帐户，可选择按类型筛选。
map_full_coa 在一次通话中将一个平台中的每个帐户映射到另一个平台。
validate_mapping 检查一组映射是否存在类型不匹配、重复和间隙。

对话示例

You:    I'm migrating from QuickBooks to Xero. What does my "Accounts Receivable" map to?

Claude: Based on the GAAP reference, your QuickBooks **Accounts Receivable** (code 1200)
        maps to Xero's **Trade Receivables** (code 120) with **high confidence**.
        Both accounts share the gaap_ref `accounts_receivable`.

You:    Great — now map my entire chart of accounts.

Claude: Here's the full mapping:

        Confident (high):
        • Cash → Cash on Hand
        • Checking Account → Business Checking
        • Accounts Receivable → Trade Receivables
        • Inventory → Stock on Hand
        • Accounts Payable → Trade Payables
        ...

        Possible (medium): ...
        Unmapped: ...

运作原理

映射采用三层置信度模型进行评分：

  1. 高 --源和目标共享相同的GAAP参考段（例如，两者都指向 accounts_receivable).这是最强烈的信号。
  2. 中等 --源和目标共享一个或多个关键字 和 具有相同的账户类型（资产、负债等）。
  3. 低 --源和目标仅共享相同的帐户类型。

每个平台的会计科目表都以JSON文件的形式存储在 src/coa_mapper_mcp/data/GAAP参考层(gaap_reference.json)提供规范的slug，将跨平台的帐户联系在一起。

贡献

添加新平台

  1. 创建 src/coa_mapper_mcp/data/<platform>.json 遵循现有架构：
    [
  {
    "code": "1000",
    "name": "Cash",
    "type": "Asset",
    "subtype": "Current Asset",
    "gaap_ref": "cash",
    "keywords": ["cash", "petty cash"],
    "description": "Cash on hand"
  }
]
  2. 将平台名称添加到 PLATFORMS 列入 src/coa_mapper_mcp/mapper.py.
  3. 将平台名称添加到 SUPPORTED_PLATFORMS 在 src/coa_mapper_mcp/__init__.py.
  4. 运行测试： pytest

运行测试

pip install -e ".[dev]"
pytest

许可证

麻省理工学院

相关 MCP