Mcp

---

什么是 BookMind？

BookMind 是一个开源 MCP 服务，为 QuickBooks Online 提供智能记账功能。与 Intuit 官方 MCP 服务（一个原始 API 封装）不同，BookMind 是一个智能记账层——你只需使用自然语言表达需求，其他事情交给它处理。

为什么选择 BookMind？

问题	解决方案
手动对交易进行分类	使用学到的规则和任意大模型，实现准确率超过 90% 的自动分类
月末结账耗时数小时	一条提示词 → 完整的结账报告包（损益表、资产负债表、现金流量表、待办事项）
银行对账繁琐	根据金额、日期和供应商自动进行模糊匹配
漏过重复付款	通过统计异常检测捕捉重复付款
催收逾期发票	以友好、坚定或升级处理的语气撰写专业邮件
供应商研究耗时	使用自然语言搜索：“我们上个季度付了多少 AWS 费用？”
受限于单一 AI 提供商	支持 OpenAI、Anthropic、Google、Groq、Mistral、NVIDIA、Ollama，也可不使用任何提供商

架构

QuickBooks Online  ──►  BookMind (this MCP)  ──►  Local SQLite
                              │
                    ┌─────────┼─────────┐
                    ▼         ▼         ▼
              Rules Engine  Memory    Anomaly Detector

• 无需依赖云服务——你的数据保存在本地 SQLite 中
• 从你的操作中学习——每次更正都会转化为持久规则
• 不依赖特定模型——支持 7 种以上的大模型提供商（也可仅使用规则）
• 不依赖特定 Agent——支持 Claude、Cursor、Cline、Continue、Windsurf、VS Code Copilot 和 Goose

---

安装

一条命令（适用于任意 MCP 客户端）

npx @bbookmind/mcp

预构建配置

Agent	配置文件	位置
Claude Desktop	install/claude-desktop.json	%APPDATA%\Claude\claude_desktop_config.json（Windows）
Cursor	install/cursor.json	~/.cursor/mcp.json
Cline	install/cline.json	VS Code → Extensions → Cline → MCP
Continue	install/continue.json	~/.continue/config.json
Windsurf	install/windsurf.json	~/.codeium/windsurf/mcp_config.json
VS Code Copilot	install/vscode-copilot.json	VS Code → GitHub Copilot → MCP

环境配置（可选）

BookMind 默认以仅规则模式运行（无需 API 密钥）。若要启用 AI 分类，请添加一个提供商的密钥：

# Pick ONE:
export GROQ_API_KEY=...        # Free tier available
export NVIDIA_API_KEY=...      # Free tier available
export GOOGLE_API_KEY=...      # Free tier available
export OPENAI_API_KEY=...
export ANTHROPIC_API_KEY=...
export MISTRAL_API_KEY=...
export OLLAMA_BASE_URL=http://localhost:11434

---

工具

BookMind 提供 14 个工具，AI Agent 会自动发现这些工具：

类别	工具	描述
分类	bookmind.categorize	自动为未分类的交易分类
	bookmind.approve_categorizations	批量批准待处理的分类
	bookmind.reject_categorizations	拒绝分类并提供反馈，自动创建规则
	bookmind.undo_categorize	从审计日志回滚
数据	bookmind.fetch_transactions	从 QBO 拉取交易、发票和账单
	bookmind.sync_to_qbo	将已批准的更改推送回 QuickBooks
对账	bookmind.reconcile	匹配银行流水 ↔ 发票/账单
智能分析	bookmind.anomalies	检测重复项、偏移和异常值
	bookmind.monthly_close	完整的月结资料（损益表、资产负债表、现金流量表）
	bookmind.vendor_search	使用自然语言搜索供应商
通信	bookmind.chase_email	生成逾期发票催款邮件
学习	bookmind.learn_rules	根据用户更正创建规则
多公司	bookmind.select_company	在不同 QBO 公司之间切换
	bookmind.list_companies	列出已连接的公司

示例提示词

"Categorize my uncategorized transactions from last month"
"Reconcile my bank feed against open invoices"
"Generate March close package"
"Any duplicate payments to vendors?"
"What did we pay AWS last quarter?"
"Draft friendly chase emails for invoices over 30 days overdue"
"Remember: Stripe transactions → Payment Processing Fees"
"Switch to Acme Corp company"

---

定价

级别	价格	交易数	公司数	功能
免费版	$0	50/月	1	仅基于规则的分类、基础供应商搜索
专业版	$29/月	1,000/月	3	AI 分类、对账、异常检测、供应商搜索
事务所版	$149/月	不限	不限	月结、催款邮件、白标 PDF、团队席位

Pro 可免费试用 14 天——无需信用卡。

---

开发

git clone https://github.com/bbookmind/mcp
cd bookmind
npm install
npm run dev      # watch mode
npm run build    # production build
npm test         # vitest

项目结构

src/
├── index.ts                # MCP server entry
├── tools/                  # 14 bookkeeping tools
│   ├── categorize.ts
│   ├── approveCategories.ts
│   ├── rejectCategories.ts
│   ├── undoCategories.ts
│   ├── fetchTransactions.ts
│   ├── syncToQbo.ts
│   ├── reconcile.ts
│   ├── anomalies.ts
│   ├── monthlyClose.ts
│   ├── vendorSearch.ts
│   ├── chaseEmail.ts
│   ├── learnRules.ts
│   ├── selectCompany.ts
│   └── listCompanies.ts
└── lib/
    ├── qbo.ts              # QuickBooks OAuth + API client
    ├── db.ts               # SQLite schema + migrations
    └── llm.ts              # Multi-provider LLM interface

---

分发渠道

• npm：npx @bbookmind/mcp
• MCP Registry：registry.modelcontextprotocol.io
• Claude Marketplace：/plugin install bookmind
• GitHub：github.com/bbookmind/mcp

---

许可证

MIT——可免费使用、修改和分发。

---

支持

• GitHub 问题
• 电子邮件