Zoho MCP服务器

Zoho MCP服务器

该项目提供了一个模型上下文协议（MCP）服务器，用于与Zoho People交互，允许您通过标准化的界面提交和检索每日状态报告（DSR）并管理项目。

特性

• 向Zoho People提交DSR条目
• 检索某个日期范围的DSR历史记录
• 列出可用项目
• 根据模式和以前的条目自动填充DSR条目

先决条件

• Node.js（建议使用v18或更高版本）
• npm（附带Node.js）
• Zoho People API凭据（客户端ID、客户端机密、刷新令牌、组织ID）

设置

1. 克隆存储库

   复制

   git clone <your-repo-url>
   cd zoho-mcp-server
   

2. 安装依赖项

   复制

   npm install
   

3. 配置环境变量 创建一个 .env 根目录中的文件，内容如下：

   复制

   ZOHO_CLIENT_ID=your_zoho_client_id
   ZOHO_CLIENT_SECRET=your_zoho_client_secret
   ZOHO_REFRESH_TOKEN=your_zoho_refresh_token
   ZOHO_ORG_ID=your_zoho_org_id
   ZOHO_BASE_URL=https://people.zoho.com  # Optional, defaults to this value
   

运行服务器

要启动MCP服务器，请执行以下操作：

npm start

或者，如果你想直接使用ts节点运行（用于开发）：

npx ts-node src/index.ts

服务器将使用stdio传输运行，并准备接受MCP请求。

项目结构

• src/index.ts -主服务器入口点
• src/zoho-client.ts -Zoho People API客户端逻辑
• src/types.ts -类型定义

许可证

麻省理工学院

在Claude AI桌面中使用此服务器作为工具提供者

您可以将此MCP服务器连接到Claude AI Desktop（或支持MCP stdio工具提供商的任何Claude客户端），以使Claude能够使用Zoho People工具。

步骤：

1. 启动MCP服务器

   • 在项目目录中打开一个终端并运行：
     复制

     npm start
     

     或（用于开发）：
     复制

     npx ts-node src/index.ts
     

2. 配置Claude AI Desktop以使用您的MCP服务器作为工具提供商

   • 在Claude AI Desktop中，转到设置或工具集成部分。
   • 添加一个新的MCP工具提供程序，并设置启动服务器的命令。例如：
     • 命令： node dist/index.js （如果您已经构建了该项目）
     • 或者： npx ts-node src/index.ts （用于TypeScript源代码）
     • 将工作目录设置为项目文件夹。

3. 使用Claude中的工具

   • 配置后，您可以通过自然语言提示要求Claude使用这些工具，例如：
     • “获取我上周的DSR历史记录。”
     • “提交今天的DSR。”
   • Claude将调用MCP服务器上的相应工具，并在其响应中使用结果。

注：

• 服务器通过stdio而不是HTTP进行通信。确保只有一个实例正在运行，并且工作目录正确。
• 您可以在中查看可用工具及其所需参数 src/index.ts 文件或通过检查Claude UI中的工具列表。