Zoho Bookkeeper MCP

MCPAI代理

提供方 bu5hm4nn · 包名 zoho-bookkeeper-mcp

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个专为Zoho Books集成设计的MCP服务器,支持AI代理的簿记工作流程,提供文件上传、账户管理和自动OAuth令牌刷新等功能。

一句话选型结论

按资料字段整理

Zoho Bookkeeper MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

财务软件TypeScript本地部署MCP服务器Zoho集成自动化簿记AI代理

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx zoho-bookkeeper-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zoho Bookkeeper MCP当前 19 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bu5hm4nn上游标注的维护方 bu5hm4nn
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时zoho-bookkeeper-mcp · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.0 KB
来自项目仓库与上游目录的原文,未做删改

Zoho簿记员MCP服务器

A. 模型上下文协议(MCP) Zoho Books集成服务器,专为使用AI代理的簿记工作流程而设计。

为什么存在

官方的Zoho MCP服务(zohomcp.com)有局限性:

  • 无法上传文件附件 -MCP架构将二进制文件参数错误地映射为查询字符串
  • 工具太多 -100+工具快速耗尽AI工具限制
  • 刀具选择难以控制 -mcp.zoho.com界面很麻烦,代理无法使用

此自定义MCP服务器提供:

  • 正确上传附件的多部分/表单数据文件
  • 一套49个簿记工作流程工具
  • 自动刷新OAuth令牌(1小时生命周期,5分钟缓冲)
  • stdio(CLI)和HTTP流传输

特性

  • 完整的CRUD操作 用于日记账、费用、账单和发票
  • 文件附件 具有适当的多部分上传支持(PDF、图像、Office文档)
  • 会计科目表 管理和事务查询
  • 银行账户 整合与交易列表
  • 联系人管理 面向客户和供应商
  • OAuth 2.0 具有自动令牌刷新功能
  • 健康检查 用于容器编排

可用工具(共49个)

类别 工具 描述
组织 2 列出组织,获取组织详细信息
会计科目表 4 列出/获取/创建帐户,列出交易
期刊 9 完整CRUD+发布+附件
开支 6 完整的CRUD+收据附件
账单 6 完整的CRUD+附件
发票 5 列表/获取+附件
联系人 2 列出/获取客户和供应商
供应商 4 供应商特定列表/获取/创建/更新工作流
银行账户 11 列出账户/交易+匹配+分类工作流程

先决条件

  • Node.js 20+
  • 拥有API访问权限的Zoho Books帐户
  • Zoho OAuth 2.0凭据(请参阅 配置)

安装

选项1:使用npx运行(建议用于桌面代理)```bash

npx zoho-bookkeeper-mcp


### 选项2:全局安装```bash
npm install -g zoho-bookkeeper-mcp
zoho-bookkeeper-mcp

选项3:Docker```bash

docker build -t zoho-bookkeeper-mcp .
docker run -p 8004:8004 \
-e ZOHO_CLIENT_ID=your_client_id \
-e ZOHO_CLIENT_SECRET=your_client_secret \
-e ZOHO_REFRESH_TOKEN=your_refresh_token \
zoho-bookkeeper-mcp


### 选项4:来源```bash
git clone https://github.com/bu5hm4nn/zoho-bookkeeper-mcp.git
cd zoho-bookkeeper-mcp
pnpm install
pnpm build

配置

运行交互式安装程序:```bash
pnpm setup


这将指导您完成:

1. 创建Zoho自助客户端应用程序
1. 输入您的客户ID和密码
1. 生成和交换授权码
1. 将凭据保存到 `.env`

### 手动配置

如果您更喜欢手动设置,请复制 `.env.example` 到 `.env` 并遵循 Zoho OAuth文档 以获得:

- `ZOHO_CLIENT_ID` -从Zoho API控制台
- `ZOHO_CLIENT_SECRET` -从Zoho API控制台
- `ZOHO_REFRESH_TOKEN` -通过具有作用域的OAuth授权代码流获得 `ZohoBooks.fullaccess.all`

### 环境变量

这 `.env` 文件应包含:```bash
# Required
ZOHO_CLIENT_ID=1000.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ZOHO_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ZOHO_REFRESH_TOKEN=1000.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Optional
ZOHO_API_URL=https://www.zohoapis.com/books/v3  # Default (US datacenter)
ZOHO_ORGANIZATION_ID=123456789                   # Default org ID (optional)
PORT=8004                                         # HTTP server port
HOST=0.0.0.0                                      # HTTP server host

API地区网址:

  • 美国(默认): https://www.zohoapis.com/books/v3
  • 欧盟: https://www.zohoapis.eu/books/v3
  • 在……里面 https://www.zohoapis.in/books/v3
  • AU: https://www.zohoapis.com.au/books/v3

与聊天代理集成

克劳德桌面版

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):```json
{
"mcpServers": {
"zoho-bookkeeper": {
"command": "npx",
"args": ["zoho-bookkeeper-mcp"],
"env": {
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}


或者,如果全局安装:```json
{
"mcpServers": {
"zoho-bookkeeper": {
"command": "zoho-bookkeeper-mcp",
"env": {
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}

Librechat

添加到您的 librechat.yaml:```yaml
mcpServers:
zoho-bookkeeper:
type: streamable-http
url: http://mcp-zoho-bookkeeper:8004/mcp
timeout: 30000


和你的 `docker-compose.yml`:```yaml
services:
mcp-zoho-bookkeeper:
build:
context: ./path/to/zoho-bookkeeper-mcp
container_name: mcp-zoho-bookkeeper
restart: unless-stopped
environment:
PORT: 8004
ZOHO_CLIENT_ID: ${ZOHO_CLIENT_ID}
ZOHO_CLIENT_SECRET: ${ZOHO_CLIENT_SECRET}
ZOHO_REFRESH_TOKEN: ${ZOHO_REFRESH_TOKEN}
ports:
- "8004:8004"
healthcheck:
test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:8004/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 30s

通用MCP客户端(HTTP)

启动HTTP服务器:```bash

Using pnpm

pnpm serve

Or directly

node dist/server.js


连接到 `http://localhost:8004/mcp` 使用流式http传输。

### 通用MCP客户端(stdio)```bash
# Using pnpm
pnpm start

# Or directly
node dist/bin.js

使用示例

获取组织ID(第一步必填)

大多数工具都需要 organization_id.先得到它:```
Use the list_organizations tool to get your Zoho organization ID


### 创建日记条目```
Create a journal entry dated 2025-01-15 with:
- Debit Office Supplies (account_id: 123456) for $150
- Credit Business Checking (account_id: 789012) for $150
Reference: "Office supplies purchase"

附上收据```

Upload the file /path/to/receipt.pdf to journal 4567890123456


### 列出最近的支出```
List all expenses from the last 30 days

发展

设置```bash

git clone https://github.com/bu5hm4nn/zoho-bookkeeper-mcp.git
cd zoho-bookkeeper-mcp
pnpm install


### 命令```bash
pnpm build        # Build TypeScript to dist/
pnpm dev          # Run with hot reload (HTTP server)
pnpm serve:dev    # Same as dev
pnpm start        # Run stdio transport
pnpm serve        # Run HTTP server

pnpm test         # Run all tests
pnpm test:unit    # Run unit tests only
pnpm test:watch   # Run tests in watch mode
pnpm test:coverage # Run tests with coverage

pnpm lint         # Check for linting errors
pnpm lint:fix     # Fix linting errors
pnpm format       # Format code with Prettier
pnpm format:check # Check formatting

项目结构```

zoho-bookkeeper-mcp/
├── src/
│ ├── index.ts # Main MCP server setup
│ ├── server.ts # HTTP server entry point
│ ├── bin.ts # CLI entry point (stdio)
│ ├── config.ts # Configuration management
│ ├── api/
│ │ ├── client.ts # Zoho API client helpers
│ │ └── types.ts # TypeScript type definitions
│ ├── auth/
│ │ └── oauth.ts # OAuth token management
│ ├── tools/
│ │ ├── organizations.ts
│ │ ├── chart-of-accounts.ts
│ │ ├── journals.ts
│ │ ├── expenses.ts
│ │ ├── bills.ts
│ │ ├── invoices.ts
│ │ ├── contacts.ts
│ │ └── bank-accounts.ts
│ ├── utils/
│ │ ├── errors.ts
│ │ ├── mime-types.ts
│ │ └── response-parser.ts
│ └── tests/ # Test files
├── dist/ # Compiled JavaScript
├── Dockerfile
├── package.json
└── tsconfig.json
```

API终点

作为HTTP服务器运行时:

端点 描述
GET /health 健康检查(返回JSON状态)
POST /mcp MCP协议端点(可流式传输http)

故障排除

“OAuth令牌无效”错误

  1. 验证您的刷新令牌是否有效
  2. 检查您的Zoho应用程序是否具有 ZohoBooks.fullaccess.all 范围
  3. 确保设置了正确的区域API URL

“找不到组织”错误

  1. 使用 list_organizations 首先获取有效的组织ID
  2. 集 ZOHO_ORGANIZATION_ID 默认组织的env-var

附件上传失败

  1. 验证服务器是否可以访问文件路径
  2. 检查是否支持文件类型(PDF、PNG、JPG、GIF、DOC、DOCX、XLS、XLSX)
  3. 确保文件大小在Zoho的限制范围内

速率限制

此服务器每次请求使用约3k个令牌,而托管的Zoho MCP(100+个工具)使用约30k个令牌。如果仍然达到速率限制,请在请求之间添加延迟。

技术栈

  • 运行时:Node.js 20+
  • 框架: FastMCP
  • 语言:TypeScript
  • 认证:OAuth 2.0,带有刷新令牌流
  • 构建:tsup
  • 测试:Vitest
  • 掉毛:ESLint+Prettier

许可证

MIT许可证-请参阅 许可证 了解详情。

贡献

欢迎投稿!请打开问题或提交拉取请求。

相关项目

  • 模型上下文协议 -协议规范
  • FastMCP -此服务器使用的MCP框架
  • Zoho图书API -Zoho Books API官方文档

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zoho Bookkeeper MCP 怎么安装?

在客户端按下面的安装命令接入:npx zoho-bookkeeper-mcp。对应的包名是 zoho-bookkeeper-mcp。装完在客户端配置里引用同一个包或端点。

Zoho Bookkeeper MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zoho Bookkeeper MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zoho Bookkeeper MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Zoho Bookkeeper MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zoho Bookkeeper MCP 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 TypeScript、Claude、AI代理。具体工具清单以官方文档为准。

Zoho Bookkeeper MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Zoho Bookkeeper MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。