AI导哈

会计自动化服务

一个专为会计实践设计的全面模型上下文协议（MCP）服务器，自动化处理簿记、税务规划、薪资处理、销售税合规和客户管理工作流程。

  • by RealDealCPA-VR
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 RealDealCPA-VR/MCP-Accounting

使用说明

🏢 会计实践MCP服务器

专为会计实务设计的综合模型上下文协议（MCP）服务器。这款定制化的MCP服务器可自动化会计记账、税务筹划、薪资处理、销售税合规以及客户管理等工作流程。

🚀 功能

📊 会计自动化

  • 自动化银行对账单处理以90%以上的准确率导入并分类交易
  • 智能交易分类具备学习能力的AI驱动费用分类
  • 重复检测识别并标记潜在的重复交易
  • 银行对账自动化对账并报告异常
  • QuickBooks 集成与QuickBooks Online/Desktop实现双向同步

💰 税务筹划与准备

  • 税负计算使用多种方法进行实时税务预测
  • 税收抵扣优化利用人工智能分析业务支出，以最大化税收优惠
  • 季度估算自动计算预估税款
  • 多实体税务策略跨多个商业实体的全面税务筹划
  • 合规监控跟踪纳税截止日期和申报要求

💼 工资处理

  • 自动薪资计算联邦、州和地方税收计算
  • 合规验证最低工资、加班费及税收限额核查
  • 税务存款计划安排自动计算所需存款及截止日期
  • 年终处理W-2表格及年度税务申报表的准备
  • 多州支持处理跨州员工事务

🏛️ 销售税合规

  • Nexus 监控实时追踪各州销售税义务
  • 经济关联警示当接近注册阈值时自动发出警报
  • 跨司法管辖区计算按州和地方准确计算销售税
  • 文件管理跟踪截止日期，并为所有司法管辖区准备申报材料
  • 审计支持全面的文件记录和审计轨迹维护

📞 客户管理

  • 客户资料/客户概况全面的客户信息与偏好管理
  • 截止日期跟踪对所有客户的税务和合规截止日期进行自动化监控
  • 文档管理客户文档的有序存储与检索
  • 自动化通信个性化的客户提醒和更新
  • 性能仪表板实时客户财务表现监控

🔄 集成

  • QuickBooks 同步与QuickBooks实现全面双向同步
  • Excel 处理各种Excel模板的自动化处理
  • PDF提取利用OCR技术从发票、收据和报表中提取数据
  • 文档自动化智能文档分类与处理

🛠️ 安装与设置

先决条件

  • Python 3.11或更高版本
  • 兼容MCP的AI客户端（如Claude Desktop等）

1. 克隆并设置

# Clone the repository
git clone <your-repo-url>
cd accounting-practice-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. 配置MCP客户端

在您的MCP客户端配置中添加（例如，Claude Desktop）：

{
  "mcpServers": {
    "accounting-practice": {
      "command": "python",
      "args": ["path/to/accounting-practice-mcp/server/main.py"],
      "cwd": "path/to/accounting-practice-mcp"
    }
  }
}

3. 初始化数据库

服务器在首次运行时会自动创建SQLite数据库：

  • server/data/client_profiles/clients.db - 客户信息和截止日期
  • server/data/client_profiles/bookkeeping.db - 交易和对账数据
  • server/data/client_profiles/tax_data.db - 税务计算与策略
  • server/data/client_profiles/payroll.db - 工资单和员工数据
  • server/data/client_profiles/sales_tax.db - 销售税和税收联系追踪
  • server/data/client_profiles/integrations.db - 集成同步历史

🎯 快速入门指南

1. 创建您的第一个客户端

# Using the MCP tools through your AI client
"Create a new client profile for ABC Company, a manufacturing business in Texas"

2. 处理银行对账单

# Upload a bank statement and let the AI categorize transactions
"Process the bank statement file for ABC Company from January 2024"

3. 进行税务筹划

# Get comprehensive tax analysis and recommendations
"Run quarterly tax planning analysis for ABC Company"

4. 计算工资

# Process payroll for employees
"Calculate payroll for ABC Company for the period 1/1/2024 to 1/15/2024"

5. 监控销售税连接点（或“销售税征税关联”）

# Check multi-state sales tax obligations
"Analyze sales tax nexus status for ABC Company across all states"

📋 可用的MCP工具

客户管理

  • get_client_info - 获取全面的客户信息
  • update_client_profile - 更新客户资料和偏好设置
  • get_client_deadlines - 获取即将到期的税务和合规截止日期

记账

  • process_bank_statement - 导入并分类银行交易
  • reconcile_accounts - 进行自动银行对账

税务筹划

  • calculate_tax_liability - 计算预估税额
  • optimize_deductions - 分析并优化业务扣除项

工资单/薪资

  • calculate_payroll - 进行薪资计算并进行合规性检查

销售税

  • sales_tax_calculation - 根据管辖地区计算销售税
  • nexus_analysis - 分析跨州的关联义务

集成

  • quickbooks_sync - 与QuickBooks同步数据
  • excel_processor - 处理Excel模板和文件
  • pdf_extractor - 从PDF文档中提取数据

🏗️ 建筑学

accounting-practice-mcp/
├── server/
│   ├── main.py                 # MCP server entry point
│   ├── tools/
│   │   ├── client_mgmt/        # Client management tools
│   │   ├── bookkeeping/        # Bookkeeping automation
│   │   ├── tax/               # Tax planning & calculations
│   │   ├── payroll/           # Payroll processing
│   │   ├── sales_tax/         # Sales tax compliance
│   │   └── integrations/      # External integrations
│   ├── data/
│   │   ├── client_profiles/   # Client databases
│   │   ├── tax_tables/        # Tax rates and tables
│   │   └── compliance/        # Compliance rules and deadlines
│   └── utils/
│       ├── calculations.py    # Financial calculations
│       ├── validators.py      # Data validation
│       └── formatters.py      # Report formatting
├── requirements.txt           # Python dependencies
├── USE_CASES_AND_WORKFLOWS.md # Detailed use cases
└── README.md                  # This file

🎨 使用场景

看 《用例与工作流程.md》 以下是关于该MCP服务器如何转变会计实务操作的全面示例。

关键场景：

  • 月度银行对账单处理4-6小时 → 15-30分钟
  • 季度税务规划2-3小时 → 30-45分钟
  • 工资处理2-4小时 → 20-30分钟
  • 销售税合规手动月度审查 → 实时监控
  • 客户沟通行政时间减少50%

🔧 定制化

添加新的税收规则

编辑 server/data/tax_tables/ 文件用于添加新的税率、税级或合规规则。

自定义交易类别

修改 server/data/categorization_rules.json 添加特定于业务的交易分类规则。

集成扩展

添加新的集成模块到 server/tools/integrations/ 用于获取额外的会计软件或服务。

客户特定的工作流程

在工具模块中自定义工作流程，以匹配您特定的客户服务方案。

🧪 测试

# Run the test suite
pytest tests/

# Test specific modules
pytest tests/test_bookkeeping.py
pytest tests/test_tax_calculations.py
pytest tests/test_payroll.py

📊 性能指标

节省时间

  • 记账处理时间缩短了75%
  • 税务准备准备时间减少了60%
  • 工资处理处理时间缩短了80%
  • 销售税合规监测时间减少90%

准确性提升

  • 数据录入错误通过自动化实现95%的减少
  • 税款计算内置合规功能，准确率高达99.9%
  • 工资单合规性100%符合自动化检查要求

业务影响

  • 客户容量用相同的员工处理三倍的客户量
  • 服务质量始终如一、专业的工作成果
  • 竞争优势基于人工智能的差异化（或“人工智能驱动的差异化”）
  • 盈利能力通过提高效率增加利润空间

🔒 安全与合规

  • 数据加密所有静态数据均加密存储
  • 访问控制基于角色的客户信息访问权限
  • 审计轨迹/审计路径全面记录所有操作
  • 备份系统自动化备份和恢复程序
  • 合规内置符合税务法规和会计准则的合规性

🤝 贡献

  1. 为仓库创建分支（或：克隆仓库）
  2. 创建一个特性分支（git checkout -b feature/amazing-feature）
  3. 提交您的更改（git commit -m 'Add amazing feature')
  4. 推送到分支（git push origin feature/amazing-feature)
  5. 提交一个拉取请求

📄 许可证

这个项目采用MIT许可证授权——详见 许可证 详情请参阅文件。

🆘 支持

如需支持、提问或提出功能请求：

  • 在仓库中创建一个问题
  • 联系开发团队
  • 查阅文档中的内容 USE_CASES_AND_WORKFLOWS.md

🚀 路线图

第一阶段（当前）

  • ✅ 核心MCP服务器实现
  • ✅ 基本会计自动化
  • ✅ 税务计算工具
  • ✅ 工资单处理
  • ✅ 销售税合规

第二阶段（下一步）

  • 🔄 高级AI分类
  • 🔄 实时QuickBooks同步
  • 🔄 移动应用集成
  • 🔄 高级报告仪表板

第三阶段（未来）

  • 📋 机器学习优化
  • 📋 预测性分析
  • 📋 高级审计支持
  • 📋 多语言支持

用人工智能驱动的自动化技术，革新您的会计业务。即刻开始！ 🚀 表情符号“🚀”在中文中通常被直接保留为原样，因为它是一个通用的表情符号，代表火箭、快速上升或加速等概念。不过，如果非要翻译其含义，可以理解为“🚀（火箭/快速上升）”。但实际使用中，直接使用该符号更为常见。

相关 MCP