AICPA 审计数据 API

全面实现 AICPA 审计数据标准（2012-2015），并集成模型上下文协议（MCP）服务器以支持AI助手。

🚀 特性

• 符合标准：实现 AICPA-ADS 规范
• AI 就绪：完全集成 MCP 以支持像 Claude 这样的AI助手
• 生产就绪：全面的错误处理和验证
• 交互式演示：用于测试 API 端点的Web界面
• Docker 支持：易于容器化部署

📋 快速开始

预备条件

• Node.js 18+
• npm 或 yarn

安装

1. 克隆仓库

   git clone https://github.com/GenAICPA/aicpa-audit-data-api.git
   cd aicpa-audit-data-api
   

2. 启动 API 服务器

   cd api-server
   cp .env.example .env
   npm install
   npm start
   

3. 启动 MCP 服务器（在新的终端中）

   cd mcp-server
   cp .env.example .env
   npm install
   npm start
   

4. 访问演示 在浏览器中打开 http://localhost:3000

Docker 设置

docker-compose up -d

📚 文档

• API 文档
• MCP 集成指南
• 部署指南

🔧 API 端点

端点	描述	参数
/api/v1/general-ledger/trial-balance	试算平衡数据	entityId, endDate
/api/v1/general-ledger/chart-of-accounts	账户分类表	entityId, level
/api/v1/general-ledger/detail	总账交易	entityId, startDate, endDate
/api/v1/subledgers/accounts-receivable	应收账款老化数据	entityId, asOfDate
/api/v1/subledgers/accounts-payable	应付账款详情	entityId, asOfDate

🤖 MCP 集成

该项目包括一个模型上下文协议服务器，使AI助手能够通过自然语言与审计数据进行交互：

// 示例AI交互
"DEMO-CORP-001 当前的现金状况是什么？"
"计算截至2024年12月31日的流动性比率"
"显示来自第四季度的所有收入交易"

📊 标准合规

• AICPA-ADS-GL-v1.0：总账标准
• AICPA-ADS-AR-v1.0：应收账款标准
• AICPA-ADS-AP-v1.0：应付账款标准
• XBRL-JSON：数据交换格式
• ISO-8601：日期格式

🧪 测试

# API 服务器测试
cd api-server && npm test

# MCP 服务器测试
cd mcp-server && npm test

🤝 贡献

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加精彩功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详细信息。

🙏 致谢

• AICPA 审计数据标准工作组
• 模型上下文协议贡献者
• 开源社区

📞 支持

• 创建问题
• 阅读文档
• 查看示例

---

⭐ 如果你觉得这个仓库有用，请给它点赞！