QuickBooks Time MCP Server (Combined)

QuickBooks Time MCP Server (Combined)

镜像

安装与设置

  1. 安装依赖:

    pip install -r requirements.txt
    
  2. 创建 .env 文件:

    QB_TIME_ACCESS_TOKEN=您的访问令牌
    NODE_ENV=development
    

运行服务器

python main.py

服务器将监听 stdin/stdout 上的 JSON-RPC 请求。

Claude 桌面配置

在 Claude Desktop 设置中添加以下配置:

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

主要功能工具

工作代码工具

  • 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_project_report: 获取详细项目报告

支持与贡献

  • 问题和功能请求:请使用 GitHub 问题页面
  • 贡献:欢迎提交 Pull Request
  • 联系:github.com/aallsbury

许可证

MIT 许可证