Zoho图书MCP服务器
通过模型上下文协议（MCP）将您的Zoho Books帐户连接到Claude Desktop等人工智能助手。
快速开始
1.获取Zoho API证书
- 首选 Zoho API控制台
- 创建“基于服务器的应用程序”
- 添加重定向URI:
http://localhost:8099/callback - 选择范围：
ZohoBooks.fullaccess.all - 保存您的客户端ID、客户端密码和组织ID
2.通过uvx安装
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"zoho-books": {
"command": "uvx",
"args": ["zoho-books-mcp"],
"env": {
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token",
"ZOHO_ORGANIZATION_ID": "your_organization_id",
"ZOHO_REGION": "US"
}
}
}
}要获取刷新令牌，请执行以下操作： uvx zoho-books-mcp --setup-oauth
3.重新启动克劳德桌面
寻找🔌 图标以验证连接。
地方发展
# Clone and setup
git clone https://github.com/kkeeling/zoho-mcp.git
cd zoho-mcp
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# Run tests
pytest
# Run server
python server.py对于Claude Desktop中的本地开发：
{
"mcpServers": {
"zoho-books": {
"command": "/path/to/venv/bin/python",
"args": ["/path/to/zoho-mcp/server.py"],
"env": {
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token",
"ZOHO_ORGANIZATION_ID": "your_organization_id",
"ZOHO_REGION": "US"
}
}
}
}可用特征
工具
发票：创建语音、电子邮件语音、记录支付、发送支付提醒、作废语音、列表语音、获取语音、标记语音发送
联系人：create_customer、create_vender、update_contact、delete_contact，email_statement，list_contacts，get_contact
开支：创建费用、更新费用、分类费用、上传费用、列表费用、获取费用
物品：创建项、更新项、列表项、获取项
销售订单：创建销售订单、更新销售订单、转换发票、列表销售订单、获取销售订单
资源
- dashboard://summary -业务指标概述
- invoice://overdue -逾期发票清单
- invoice://unpaid -未付发票
- payment://recent -最近付款
- contact://list -所有联系人
- expenses://summary -费用概述
提示
- 发票收集工作流 -完成发票到付款周期
- 每月发音 -批量发票创建
- 费用跟踪工作流程 -费用记录和分类
配置
区域
- 美国（zoho.com）、欧盟（zoho.EU）、印度（zoho.IN）、澳大利亚（zoho.com.AU）、日本（zoho.JP）、英国（zoho.UK）、加拿大（zoho.CA）
故障排除
- 工具未显示：完全重新启动克劳德桌面
- 认证错误：使用重新生成刷新令牌
uvx zoho-books-mcp --setup-oauth - 模块错误：确保虚拟环境已激活
开发与发布
创建发布
要将新版本发布到PyPI并创建GitHub版本，请执行以下操作：
- 更新版本 在……里面
pyproject.toml - 更新CHANGELOG.md 附发行说明
- 创建并推送一个git标签:
git tag v0.1.0
git push origin v0.1.0- 遵循手动发布步骤 在……里面
PUBLISHING.md构建、上传到PyPI并创建GitHub版本
出版的先决条件
- 带有API令牌的PyPI帐户
- GitHub命令行界面(
gh)已安装并验证 - 构建工具：
pip install --upgrade pip build twine
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。#� �z�o�h�o�b�o�o�k�s�-�m�c�p�-�s�e�r�v�e�r� � �#� �z�o�h�o�b�o�o�k�s�-�m�c�p�-�s�e�r�v�e�r� � �