使用说明

项目简介

Todoist MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它充当 LLM 客户端与 Todoist 任务管理应用之间的桥梁。通过此服务器，LLM 可以安全、可控地访问和操作用户的 Todoist 数据，实现智能化的任务管理和自动化工作流程。

主要功能点

任务管理: 提供创建、查看、更新、完成、重新打开和删除 Todoist 任务的工具。
项目管理: 支持获取、创建、更新和删除 Todoist 项目。
** सेक्शन 管理**: 允许获取、创建、更新和删除 Todoist 项目下的 सेक्शन。
资源访问: 通过工具函数将 Todoist 的任务、项目和 सेक्शन 作为资源暴露给 LLM 客户端。
工具注册: 注册了丰富的 Todoist 操作工具，方便 LLM 进行调用。
标准MCP协议: 基于 FastMCP 框架构建，遵循 MCP 协议标准，易于集成到支持 MCP 协议的 LLM 客户端。
Stdio传输: 默认使用 Stdio 作为传输协议，配置简单，易于部署。

安装步骤

安装 Python 3.10+ 和 UV 包管理器: 请确保您的系统已安装 Python 3.10 或更高版本，并按照 UV 官方安装指南安装 UV 包管理器。
获取 Todoist API Token:
- 登录您的 Todoist 账户。
- 进入 "Settings" (设置) -> "Integrations" (集成)。
- 在 "Developer" (开发者) 下找到您的 API token。

克隆仓库: 将 'todoist-mcp-server' 仓库克隆到本地：

git clone https://github.com/mikemc/todoist-mcp-server
cd todoist-mcp-server

安装依赖: 使用 UV 安装项目依赖：
```
uv pip install .
```

服务器配置

MCP 服务器需要配置 Todoist API Token 才能正常工作。您需要将以下 JSON 配置添加到您的 MCP 客户端（例如 Claude Desktop）的配置文件 'claude_desktop_config.json' 中。

{
  "mcpServers": {
    "todoist": {  // 服务器名称，可以自定义
      "command": "uv", // 启动命令，这里使用 uv 包管理器
      "args": [     // 命令参数
        "--directory",  // 指定工作目录
        "/absolute/path/to/todoist-mcp-server", //  请替换为 todoist-mcp-server 仓库的绝对路径
        "run",          // 运行命令
        "main.py"      // 主程序文件
      ],
      "env": {       // 环境变量
        "TODOIST_API_TOKEN": "your_todoist_api_token" // 请替换为您在 Todoist 获取的 API Token
      }
    }
  }
}

配置参数说明:

'"todoist"': MCP 服务器的名称，您可以自定义，用于在客户端中引用该服务器。
'"command": "uv"': 指定用于启动服务器的命令为 'uv'，您需要确保 UV 包管理器已安装并可在命令行中访问。
'"args"': 启动命令的参数列表。
- '"--directory", "/absolute/path/to/todoist-mcp-server"': 指定服务器程序的工作目录为克隆的 'todoist-mcp-server' 仓库的绝对路径。请务必将 '/absolute/path/to/todoist-mcp-server' 替换为您的实际路径。
- '"run", "main.py"': 指示 UV 运行 'main.py' 文件来启动服务器。
'"env"': 环境变量配置。
- '"TODOIST_API_TOKEN": "your_todoist_api_token"': 设置 'TODOIST_API_TOKEN' 环境变量，请将 '"your_todoist_api_token"' 替换为您从 Todoist 账户获取的 API Token。 这是服务器连接 Todoist API 的凭证。

基本使用方法

启动 MCP 服务器: 配置完成后，在 MCP 客户端中启动名为 'todoist' 的 MCP 服务器。服务器将会在后台运行，并通过 Stdio 与客户端通信。
在 LLM 中调用工具: 您可以在支持 MCP 协议的 LLM 客户端中，通过自然语言指令或特定语法来调用服务器提供的工具。例如，您可以指示 LLM “创建一个名为 ‘购物清单’ 的 Todoist 项目”，客户端会将请求转发给 Todoist MCP Server，服务器调用相应的 'todoist_add_project' 工具在您的 Todoist 账户中创建项目。
查看可用工具: 您可以通过以下命令查看当前服务器注册的所有工具（需要在仓库根目录下执行）：
```
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py
```
或者直接查看 'README.md' 文件中 "Available Tools" 部分。

注意: 此服务器默认使用 Stdio 传输协议，适用于本地环境或客户端与服务器在同一机器部署的情况。如果您需要使用其他传输协议（如 WebSocket, SSE），可能需要修改 'main.py' 中的 'mcp.run()' 调用。

关键词