项目简介：这是一个基于Model Context Protocol (MCP) 的服务器端程序，专为macOS用户设计，用于集成流行的任务管理应用Things 3。它允许支持MCP协议的大型语言模型（LLMs），如Claude Desktop或Claude Code，通过Things 3的自动化接口（URL Scheme和AppleScript）与您的待办事项、项目、区域和标签等进行交互。

主要功能：

创建新的待办事项和项目，支持设置日期、标签、清单、所属项目/区域等详细信息。
更新现有的待办事项和项目（需要Things 3认证令牌）。
获取和列出Things 3中特定列表（如收件箱、今天、日志簿、特定项目等）中的项目。
获取所有项目、区域和标签列表。
获取单个待办事项的详细信息（如截止日期、备注、状态等）。
在Things 3中导航到特定列表或项目。
在Things 3中执行搜索。

安装步骤：

确保您的macOS系统已安装Things 3和Node.js 18或更高版本。
从GitHub克隆本项目到您的本地目录。
进入项目目录，运行 'npm install' 安装所有依赖。
运行 'npm run build' 构建项目，生成可执行文件。

服务器配置：要将此MCP服务器连接到您的LLM客户端（例如Claude Desktop），您需要在客户端的MCP设置中添加一个配置项。配置通常是一个JSON对象，指示客户端如何启动并与此服务器通信。一个典型的配置示例如下（您需要根据实际情况调整路径，客户端会根据您的设置来启动此服务器）：

{
  "您为服务器定义的唯一标识符，例如 things-mcp": {
    "command": "启动MCP服务器的可执行文件或解释器，例如 node",
    "args": [
      "服务器主启动脚本的绝对路径，例如 /Users/您的用户名/things-mcp/dist/index.js"
    ],
    "env": {
      "THINGS_AUTH_TOKEN": "您的Things 3认证令牌" // 可选，但更新操作需要。在Things 3设置 -> 通用 -> 启用Things URL -> 管理 -> 复制令牌 获取。
    }
  }
}

请将 '"您为服务器定义的唯一标识符"' 替换为您喜欢的名称，将 '/Users/您的用户名/things-mcp' 替换为您实际克隆项目的路径。确保 'THINGS_AUTH_TOKEN' 环境变量正确设置，特别是如果您想使用更新功能。

基本使用方法：一旦MCP服务器在您的LLM客户端中配置并成功启动，您就可以在与LLM交互时，通过自然语言请求其调用Things 3的功能。LLM会理解您的请求，并根据其内置的能力和您配置的工具列表，自动调用相应的MCP工具来与Things 3互动。例如：

创建任务："在Things里创建任务'去超市买菜'，定在今天下午"
创建项目："在Things里创建项目'年度旅行计划'，备注：研究目的地和预订"
列出任务："给我看看Things收件箱里的所有任务"
更新任务："把ID为 ABC-123 的任务在Things里标记为已完成"
导航："打开Things里的今天列表"
搜索："在Things里搜索'会议'相关的项目或任务"

关键词

信息