使用说明

项目简介

Things3 Integration Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在连接大型语言模型 (LLM) 与 Things3 任务管理应用。它允许用户通过 LLM 以自然语言指令操作 Things3，实现任务和项目的自动化管理。此服务器利用 MCP 协议提供的标准化接口，为 LLM 应用提供访问和控制 Things3 功能的能力。

主要功能点

查看任务和项目：检索并展示 Things3 中的任务和项目信息，包括收件箱任务、今日任务和项目列表。
创建项目：在 Things3 中创建新的项目，支持设置标题、备注、区域、计划日期、截止日期和标签等详细属性。
创建待办事项：在 Things3 中创建新的待办事项，支持设置标题、备注、计划日期、截止日期、清单、标签、所属列表和标题等详细属性。
工具集成：将 Things3 的各项功能封装为 MCP 工具，供 MCP 客户端（如 LLM 应用）调用，实现与 Things3 的无缝集成。

安装步骤

环境准备：确保您的 macOS 系统已安装 Python 3.8 或更高版本，并且已安装 Things3 应用程序。

克隆仓库：使用 Git 克隆该 GitHub 仓库到本地：

git clone https://github.com/drjforrest/mcp-things3

进入目录：切换到克隆的仓库目录：
```
cd mcp-things3
```
安装依赖：使用 pip 安装项目依赖：
```
pip install -e .
```

服务器配置

MCP 服务器需要由 MCP 客户端启动和连接。您需要在 MCP 客户端中配置以下服务器信息，以便客户端能够正确启动和连接到 Things3 Integration Server。

{
  "serverName": "mcp-server-things3",
  "command": "python",
  "args": ["-m", "mcp_server_things3.server"]
}

'serverName': 服务器名称，用于在 MCP 客户端中标识该服务器。
'command': 启动服务器的命令。这里使用 'python' 命令来运行 Python 脚本。
'args': 传递给启动命令的参数列表。
- '"-m"': Python 的 '-m' 参数用于运行模块作为脚本。
- '"mcp_server_things3.server"': 指定要运行的 Python 模块，即服务器的入口脚本。

基本使用方法

启动服务器：当配置了上述服务器信息的 MCP 客户端启动后，会自动启动 Things3 Integration Server。或者，您也可以在项目根目录下手动运行服务器：
```
python -m mcp_server_things3.server
```
通过 MCP 客户端交互：使用兼容 MCP 协议的客户端（如 LLM 应用）与服务器进行通信。客户端可以调用服务器提供的工具（例如 'create-things3-project'、'view-inbox'）来管理 Things3 中的任务。例如，您可以指示 LLM “在 Things3 中创建一个名为 ‘购物清单’ 的项目，备注为 ‘购买日常用品’”。LLM 作为 MCP 客户端，会调用 'create-things3-project' 工具在 Things3 中完成项目创建。

关键词