Name: Zoho Books账户管理服务
Author: fordez

使用说明

Zoho图书MCP服务器

该项目提供了一个Python/FastAPI应用程序来管理多个Zoho Books帐户，并公开了一个MCP（微控制协议）接口，以便通过自动化工具与它们进行交互。

该应用程序允许您：

克隆存储库：

git clone <URL_OF_YOUR_REPOSITORY>
cd <NAME_OF_YOUR_REPOSITORY>

配置环境变量：

创建一个 .env 基于项目根目录的文件 .env.example （如果存在）或根据中定义的所需变量 config.py 和 docker-compose.yml。您至少需要定义以下变量（根据您的Zoho环境调整值）：
- ZOHO_CLIENT_ID：您的Zoho应用程序的客户端ID。
- ZOHO_CLIENT_SECRET：您的Zoho应用程序的客户端密码。
- ZOHO_REDIRECT_URI：Zoho应用程序中配置的重定向URI（默认为 http://localhost:8000/oauth/callback).
- MCP_PORT：MCP接口的内部端口（默认为 8001).
- APP_PORT：web界面的外部端口（默认为 8000).
示例 .env 内容：
```
ZOHO_CLIENT_ID=your_client_id_here
ZOHO_CLIENT_SECRET=your_client_secret_here
ZOHO_REDIRECT_URI=http://localhost:8000/oauth/callback
MCP_PORT=8001
APP_PORT=8000
```
使用Docker Compose构建和运行：
```
docker-compose up -d --build
```
此命令将构建应用程序映像（如果需要）并启动中定义的容器 docker-compose.yml 在后台(-d).

访问Web界面：

打开您的网络浏览器并导航到 http://localhost:[APP_PORT] （默认值为 http://localhost:8000).
- 在这里，您可以管理您的Zoho Books帐户（连接新帐户、选择活动帐户、删除）。
- 您将看到您的外部代理或工具应使用的MCP服务器URL。
连接Zoho帐户：
- 在web界面中，单击“🚀 连接Zoho图书”按钮。
- 登录您的Zoho帐户并授权该应用程序。
- 如果这是一个没有组织的新帐户，您将被重定向到Zoho Books设置页面以创建一个。
使用MCP接口：

您的外部MCP服务器应指向 http://localhost:[APP_PORT]/mcp （例如。， http://localhost:8000/mcp)通过此应用程序与Zoho Books进行交互。
访问工具文档：
- 在主web界面中，单击“📘 工具文档”按钮。
- 将打开一个新页面，其中包含有关可用工具及其响应的详细文档。
停止容器：
```
docker-compose down
```