Coa Mapper MCP

coa成像仪mcp

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

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

支持的平台

快速开始

安装

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，工具将立即可用。

工具

对话示例

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/

.json` 遵循现有架构：

   [
     {
       "code": "1000",
       "name": "Cash",
       "type": "Asset",
       "subtype": "Current Asset",
       "gaap_ref": "cash",
       "keywords": ["cash", "petty cash"],
       "description": "Cash on hand"
     }
   ]

1. 将平台名称添加到 PLATFORMS 列入 src/coa_mapper_mcp/mapper.py.
2. 将平台名称添加到 SUPPORTED_PLATFORMS 在 src/coa_mapper_mcp/__init__.py.
3. 运行测试： pytest

运行测试

pip install -e ".[dev]"
pytest

许可证

麻省理工学院