publicPublicdnsLocal runtime

things-fastmcp

Things MCP服务器是一个基于Model Context Protocol的项目，它允许用户通过Claude Desktop与Things任务管理应用进行交互，实现自然语言创建任务、智能分析项目等功能。

article

README

🚀 配置 Things MCP 服务器

本项目提供了配置 Things MCP 服务器的详细步骤，帮助你快速搭建并使用该服务器，同时也提供了故障排除的相关信息。

🚀 快速开始

要配置 Things MCP 服务器，请按照以下步骤操作：

1. 克隆仓库

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

2. 设置开发环境

uv venv
uv pip install -e ".[dev]"  # 以开发模式安装，包含额外依赖项

3. 测试更改

使用 MCP 开发服务器测试更改：

mcp dev things_fast_server.py  # 测试 FastMCP 实现
# 或者测试传统实现
mcp dev things_server.py

4. 构建包

python -m build

5. 发布到 PyPI

twine upload dist/*

⚠️ 重要提示

需要 Python 3.12+。

🔧 故障排除

服务器包含错误处理功能，可处理以下问题：

无效的 UUID
缺少必需参数
访问 Things 数据库错误
数据格式错误
认证令牌问题

常见问题

缺失或无效令牌：运行 python configure_token.py 设置你的令牌。
Things 应用未运行：确保在使用 MCP 服务器时，Things 3 已打开。
URL 方案未启用：检查 Things → 偏好设置 → 通用，确保“启用 Things URL”已启用。

查看日志

所有错误都会记录并返回带有描述性消息。要查看 Claude Desktop 的 MCP 日志，请运行以下命令：

# 实时跟踪最后 20 行日志
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

badge

Publisher / author / owner

person

excelsierMCP Server

open_in_newSource repository

Detail synced2026-05-20 02:11:19IDexcelsier-things-fastmcp

data_object

Technical config

server_config

{
  "rating": 2.5,
  "dev_lang": "python",
  "mcp_install": {
    "mcpServers": {
      "things": {
        "args": [
          "--directory",
          "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
          "run",
          "things_server.py"
        ],
        "command": "uv"
      }
    }
  }
}

Discovery labels

Categories

Productivity

Tags

任务管理AI集成生产力工具

Locales

zh_cn

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

Open provider connection page
Authorize or copy endpoint
Connect from your MCP client

terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

Copy server_config
Install required package
Fill env variables and restart client