项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器实现，专门用于集成Wrike工作管理平台。它允许兼容MCP的AI客户端（如Anthropic Claude Desktop应用）通过结构化的方式与Wrike API进行交互，从而让AI能够理解和操作您的Wrike工作空间中的数据。

主要功能点

通过本MCP服务器，AI客户端可以执行以下针对Wrike的操作：

数据读取：
- 列出并获取Wrike中的空间、文件夹、项目。
- 获取任务详情或按条件搜索任务。
- 获取任务或文件夹下的评论。
- 获取联系人（用户）信息。
- 获取时间日志并支持多种筛选条件（按任务、用户、文件夹、日期等）。
- 获取时间日志类别。
- 获取自定义项类型和自定义字段定义。
- 获取文件夹蓝图和任务蓝图。
数据操作：
- 在指定父级下创建新的文件夹或项目。
- 在指定文件夹/项目下创建新的任务。
- 更新现有任务的详情。
- 在任务下创建评论。
- 为任务创建、更新或删除时间日志条目。
- 从自定义项类型或蓝图创建工作项（任务/项目）。

安装步骤

本服务器是一个Node.js应用。您需要先安装Node.js环境。

克隆仓库: 使用Git克隆项目仓库到您的本地计算机。 'git clone https://github.com/katoiek/mcp-server-wrike.git' 'cd mcp-server-wrike'
安装依赖: 进入项目目录，使用npm安装所需的依赖包。 'npm install'
构建项目: 项目使用TypeScript编写，需要编译成JavaScript。 'npm run build'

完成以上步骤后，您将在 'dist' 目录下找到可执行的 'server.js' 文件。

服务器配置 (用于MCP客户端)

本MCP服务器设计为由兼容的MCP客户端（如Claude Desktop）直接启动和管理。您需要在客户端的配置文件中添加本服务器的启动信息。典型的配置（JSON格式）如下所示：

{
  "mcpServers": {
    "wrike": { // 您为该服务器指定的名称
      "command": "node", // 启动命令，通常是 "node" 或 "npx"
      "args": ["/path/to/mcp-server-wrike/dist/server.js"], // 启动参数，这里是服务器脚本的路径
      "env": { // 需要传递给服务器的环境变量
        "WRIKE_ACCESS_TOKEN": "your-wrike-access-token", // 您的Wrike API永久访问令牌
        "WRIKE_HOST": "www.wrike.com", // Wrike API主机，默认为www.wrike.com
        "NODE_ENV": "production", // Node.js环境模式
        "LOG_LEVEL": "warn" // 日志级别，可选error, warn, info, debug, trace
      }
    }
  }
}

将 '/path/to/mcp-server-wrike/dist/server.js' 替换为您实际的项目路径。
将 'your-wrike-access-token' 替换为您的Wrike API永久访问令牌。您可以在Wrike的Apps & Integrations > API页面生成此令牌。
'WRIKE_HOST' 通常不需要修改，除非您使用特定的Wrike实例。
'LOG_LEVEL' 可根据需要调整日志详细度。

请将此配置添加到您的MCP客户端（例如Claude Desktop）的配置文件中。

基本使用方法

配置完成后，启动您的AI客户端。AI客户端将自动启动配置好的MCP服务器。然后，您就可以在与AI的对话中请求执行与Wrike相关的任务。

对话中提及“Wrike”以及您想操作的具体内容（如空间、任务、时间日志等）和必要的识别信息（如任务名称、ID、日期范围等），AI便会识别并调用相应的工具来与Wrike交互。

例如：

"列出我在Wrike中的所有空间。"
"请获取Wrike中ID为 'ABCDE123' 的任务详情。"
"在Wrike中创建一个名为 '编写季度报告' 的任务，放入 '项目A' 文件夹。"
"汇总我上周在Wrike中记录的所有时间日志。"

AI将通过MCP服务器调用Wrike API，并将结果反馈给您。

关键词

信息