技术文档摘要

🧾 QuickBooks MCP 服务器

一个安全、以本地优先的模型上下文协议（MCP）服务器，用于在 Claude Desktop 中使用自然语言查询 QuickBooks 数据。

---

✅ MCP 审核认证

此 MCP 服务器已通过 MCP 审核认证。

被列为 MCP 审核认证确保该服务器符合 MCP 标准和最佳实践，并受到开发者社区的信任。

---

要求：

1. Python 3.10 或更高版本

环境设置

对于本地开发，在项目根目录中创建一个包含 QuickBooks 凭证的 .env 文件：

# 复制模板并填写实际凭证
cp env_template.txt .env

然后编辑 .env 文件，填入您的实际 QuickBooks API 凭证：

QUICKBOOKS_CLIENT_ID=your_actual_client_id
QUICKBOOKS_CLIENT_SECRET=your_actual_client_secret
QUICKBOOKS_REFRESH_TOKEN=your_actual_refresh_token
QUICKBOOKS_COMPANY_ID=your_actual_company_id
QUICKBOOKS_ENV='sandbox' 或 'production'

**注意：**出于安全考虑，.env 文件会自动被 git 忽略。

第一步：安装 uv

• MacOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

第二步：配置 Claude Desktop

1. 下载 Claude Desktop。
2. 启动 Claude 并进入 设置 > 开发者 > 编辑配置。
3. 修改 claude_desktop_config.json 文件如下：

{
  "mcpServers": {
    "QuickBooks": {
      "command": "uv",
      "args": [
        "--directory",
        "<绝对路径到 quickbooks_mcp 文件夹>",
        "run",
        "main_quickbooks_mcp.py"
      ]
    }
  }
}

4. 重新启动 Claude Desktop。

首次打开 Claude Desktop 时，由于需要安装所需包并下载最新的 QuickBooks API 文档，可能需要等待 10-20 秒才能看到 QuickBooks 工具出现在界面中。

每次启动 Claude Desktop 时，都会提供最新的 QuickBooks API 工具给您的 AI 助手。

第三步：启动 Claude Desktop 并让您的助手帮助您

示例

查询账户

从 QuickBooks 获取所有账户。

查询账单

从 QuickBooks 获取所有在 2024-01-01 之后创建的账单。

查询客户

从 QuickBooks 获取所有客户。