QuickBooks Time MCP Server (Combined)

基本能力

产品定位

QuickBooks Time MCP Server 是一个集成化的工具，旨在通过单一接口提供对 QuickBooks Time API 所有功能的访问，简化开发者的集成工作。

核心功能

1. JobCode Tools: 提供对工作代码的查询和管理功能，包括获取工作代码、工作代码层次结构等。
2. Timesheet Tools: 提供对时间表的查询功能，包括获取特定时间表、当前活动时间表等。
3. User Tools: 提供对用户的查询功能，包括获取所有用户、特定用户、当前认证用户等。
4. Project Management Tools: 提供对项目和项目活动的查询功能。
5. Reports Tools: 提供多种报告功能，包括当前总计、工资单报告、项目报告等。
6. Additional Tools: 提供其他辅助功能，如获取自定义字段、最后修改时间戳、通知等。

适用场景

1. 企业财务管理: 用于查询和管理 QuickBooks Time 中的时间表、工资单报告等财务数据。
2. 项目管理: 用于查询和管理项目及其活动，生成项目报告。
3. 用户管理: 用于查询和管理用户信息，包括当前认证用户和用户组。
4. 开发集成: 为开发者提供统一的接口，简化与 QuickBooks Time API 的集成工作。

工具列表

1. JobCode Tools:
2. get_jobcodes: 获取工作代码，支持高级过滤选项。
3. get_jobcode: 获取特定工作代码。
4. get_jobcode_hierarchy: 获取完整的工作代码层次结构。
5. Timesheet Tools:
6. get_timesheets: 获取时间表，支持过滤。
7. get_timesheet: 获取特定时间表。
8. get_current_timesheets: 获取当前活动时间表。
9. User Tools:
10. get_users: 获取所有用户，支持过滤。
11. get_user: 获取特定用户。
12. get_current_user: 获取当前认证用户。
13. get_groups: 获取所有用户组。
14. Project Management Tools:
15. get_projects: 获取项目，支持过滤。
16. get_project_activities: 获取项目活动。
17. Reports Tools:
18. get_current_totals: 获取当前总计快照。
19. get_payroll: 获取工资单报告。
20. get_payroll_by_jobcode: 按工作代码分组的工资单报告。
21. get_project_report: 获取详细项目报告。
22. Additional Tools:
23. get_custom_fields: 获取自定义跟踪字段。
24. get_last_modified: 获取对象的最后修改时间戳。
25. get_notifications: 获取通知。
26. get_managed_clients: 获取托管客户端。

常见问题解答

1. 如何安装依赖？ bash pip install -r requirements.txt
2. 如何配置访问令牌？ 创建 .env 文件并添加以下内容： QB_TIME_ACCESS_TOKEN=your_access_token_here NODE_ENV=development
3. 如何运行服务器？ bash python main.py

使用教程

使用依赖

1. 确保已安装 Python 和 pip。
2. 运行以下命令安装依赖： bash pip install -r requirements.txt

安装教程

1. 克隆项目仓库。
2. 创建 .env 文件并配置访问令牌： QB_TIME_ACCESS_TOKEN=your_access_token_here NODE_ENV=development
3. 运行服务器： bash python main.py

调试方式

1. 确保服务器已启动并运行。
2. 使用 JSON-RPC 请求通过 stdin/stdout 与服务器交互。
3. 检查日志和错误信息以排查问题。

支持与贡献

对于问题和功能请求，请使用 GitHub issues 页面或直接联系作者。欢迎贡献代码，尤其是通过 Pull Request 提交改进。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。