QuickBooks数据查询服务器

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

  • by nikhilgy
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 nikhilgy/quickbooks-mcp-server

使用说明

🧾 QuickBooks MCP服务器

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


✅ MCP审查认证

此MCP服务器是 经MCP审查认证.

在MCP Review上列出和认证可确保此服务器符合MCP标准和最佳实践,并受到开发人员社区的信任。


要求:

  1. Python 3.10或更高版本

环境设置

为了地方发展,创建一个 .env 项目根目录中的文件,其中包含您的QuickBooks凭据:

# Copy the template and fill in your actual credentials
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' or 'production'

注: 这 .env 出于安全原因,git会自动忽略该文件。

步骤1。安装紫外线:

  • MacOS/Linux:curl-LsSfhttps://astral.sh/uv/install.sh|sh
  • Windows:powershell-执行策略ByPass-c“irmhttps://astral.sh/uv/install.ps1|iex”

步骤2。配置Claude桌面

  1. 下载 克劳德桌面.
  2. 启动Claude并转到“设置”>“开发人员”>“编辑配置”。
  3. 修改 claude_desktop_config.json 与:
{
  "mcpServers": {
    "QuickBooks": {
      "command": "uv",
      "args": [
        "--directory",
        "<absolute_path_to_quickbooks_mcp_folder>",
        "run",
        "main_quickbooks_mcp.py"
      ]
    }
  }
}
  1. 重新启动克劳德桌面。

首次使用这些设置打开Claude Desktop时,可能需要 由于以下原因,QuickBooks工具出现在界面前10-20秒 安装所需的软件包并下载最新的 最新的QuickBooks API文档。

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

步骤3。启动Claude Desktop,让您的助手帮助您

例子

查询帐户

Get all accounts from QuickBooks.

查询账单

Get all bills from QuickBooks created after 2024-01-01.

查询客户

Get all customers from QuickBooks.