🚀 配置 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