← 返回 MCP 目录

public公开dns本地运行

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

发布者 / 作者 / 所有者

person

excelsierMCP Server

open_in_new来源仓库

详情同步2026-05-20 02:11:19IDexcelsier-things-fastmcp

data_object

技术配置

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"
      }
    }
  }
}

category

分类信息

分类

效率工具

标签

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

语言

zh_cn

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

打开服务方连接页
完成授权或复制端点
在 MCP 客户端中连接

terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

复制 server_config
安装所需依赖
补齐环境变量后重启客户端