Things App

🚀 事項 MCP 服務器

這個 模型上下文協議 (MCP) 服務器可讓你藉助 Claude 桌面版，與 Things 應用 中的任務管理數據進行交互。你能讓 Claude 創建任務、分析項目、協助管理優先級等。

該服務器藉助了 Things.py 庫和 Things URL 方案。

🚀 快速開始

此服務器能讓你使用 Claude 桌面版與 Things 應用中的任務管理數據交互，實現創建任務、分析項目等功能。

✨ 主要特性

• 可訪問所有主要的 Things 列表（收件箱、今天、即將進行等）
• 支持項目和領域管理
• 能進行標籤操作
• 具備高級搜索功能
• 可跟蹤最近項目
• 提供詳細的任務信息，包括檢查列表
• 支持嵌套數據（領域中的項目、項目中的待辦事項）

📦 安裝指南

適用於 Claude 桌面版

1. 先決條件
   • Python 3.12+
   • Claude 桌面版
   • Things 3 （“啟用 Things URLs” 必須在設置 -> 通用中打開）
2. 若尚未安裝，安裝 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

重新啟動終端。 3. 克隆此倉庫：

git clone https://github.com/hald/things-mcp

4. 安裝所需的 Python 包：

cd things-mcp
uv venv
uv pip install -r pyproject.toml

5. 編輯 Claude 桌面版配置文件：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

在 JSON 數組中添加以下內容：

{
  "mcpEndpoints": [
    {
      "name": "Things",
      "url": "http://localhost:9001"
    }
  ]
}

💻 使用示例

基礎用法

提供一些在 Claude 桌面版中使用該服務器的示例問題：

• 列出所有項目和待辦事項。
• 創建新的任務或項目。
• 根據截止日期篩選任務。
• 更新現有任務的狀態或屬性。

小貼士

⚠️ 重要提示

該服務器包括對以下錯誤的處理：無效的 UUID、缺少必填參數、Things 數據庫訪問錯誤、數據格式錯誤。所有錯誤都會記錄並帶有描述性消息返回。

💡 使用建議

• 在設置中啟用 Things 數據庫的日誌記錄，以便更好地調試和監控：

defaults write com.culturedcode.Things-MacOS developer-mode -bool true

• 使用 poetry run 命令運行服務器以隔離依賴項環境。

📚 詳細文檔

可用工具

查詢工具

• /items
  獲取 Things 數據庫中的所有項目和待辦事項。支持分頁加載更多數據。

創建工具

• /items/create
  在 Things 中創建新的任務或項目。

更新工具

• /items/update
  更新現有任務或項目的屬性和狀態。

工具參數

查詢工具 (/items)

創建工具 (/items/create)

更新工具 (/items/update)

故障排除

要查看 Claude 桌面版的 MCP 日誌，請在終端中運行：

# 即時跟蹤最後 20 行日誌
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log