QuickBooks Time MCP Server (Combined)

简介

这是一个综合的MCP服务器，通过单一接口提供对所有QuickBooks Time API功能的访问，包括工作代码管理、报告生成、时间表管理和用户管理等功能。

快速安装

1. 安装依赖项:

pip install -r requirements.txt

2. 创建.env文件:

QB_TIME_ACCESS_TOKEN=你的访问令牌
NODE_ENV=development

Claude桌面配置

在Claude桌面设置中添加以下配置:

{
  "globalShortcut": "Ctrl+Q",
  "mcpServers": {
    "qb-time-tools": {
      "command": "python",
      "args": ["./qb-time-mcp-server/main.py"],
      "env": {
        "QB_TIME_ACCESS_TOKEN": "你的QuickBooks访问令牌"
      }
    }
  }
}

启动服务器

python main.py

主要功能概览

工作代码管理

• get_jobcodes: 获取工作代码列表（支持筛选）
• get_jobcode: 获取单个工作代码
• get_jobcode_hierarchy: 获取工作代码层次结构

时间表管理

• get_timesheets: 获取时间表列表
• get_timesheet: 获取单个时间表
• get_current_timesheets: 获取当前活动时间表

用户管理

• get_users: 获取用户列表
• get_user: 获取单个用户信息
• get_current_user: 获取当前用户信息
• get_groups: 获取所有用户组

报告工具

• get_current_totals: 获取当前时间总计
• get_payroll: 获取工资报告
• get_payroll_by_jobcode: 获取按工作代码分组的工资报告
• get_project_report: 获取项目详细报告

其他工具

• get_projects: 获取项目列表
• get_custom_fields: 获取自定义字段
• get_last_modified: 获取对象最后修改时间
• get_notifications: 获取通知

许可和贡献

• 使用MIT许可证
• 欢迎通过GitHub提交问题和改进建议

注: 此项目在AI协助下开发，欢迎社区反馈和改进