yattMCP (Mjkoo)

yattmcp

还有另一个TickTick MCP——一个MCP服务器，它为人工智能代理提供TickTik上的完整任务管理，而不会暴露每个API恶意软件。

为什么是这个？

大多数TickTick MCP服务器要么以1:1镜像原始API（数字优先级、奇怪的日期格式、内部字段，如 sortOrder)或者使用50多个“工作流”工具，这些工具会扩大工具列表并混淆模型选择。yattmcp采取了不同的方法：

9个工具。完全CRUD。对代理友好的抽象。

• 标准化数据 --优先级是 "high"，不 5.接受日期 "2025-03-15" 并得到转换。 isAllDay 根据您的日期格式自动检测。子任务包括 {title, isCompleted}，不 {title, status: 0}.
• 一个可组合的搜索工具 --而不是分开 get_overdue_tasks, get_todays_tasks, get_high_priority_tasks 工具，只有一个 ticktick_search_tasks 带有与AND逻辑组合的可选过滤器。想要逾期的高优先级任务吗？一个电话。
• 坦诚面对局限性 --工具描述告诉代理，已完成的任务是不可检索的，完成是单向的，两者都是 taskId 和 projectId 需要（以及为什么）。没有无声的失败。
• 工具注释 --每个工具都声明 readOnlyHint, destructiveHint，以及 idempotentHint 因此，代理人可以在致电之前对风险进行推理。

认证

yattmcp使用通过 TICKTICK_API_TOKEN 环境变量。

获得代币的最简单方法是直接从TickTick获得： 简介->设置->订阅->API代币。这为您提供了一个不会过期的长期令牌。

或者，您可以使用通过TickTick获得的OAuth2访问令牌 开发者门户，但您需要自己处理令牌刷新——yattmcp不管理OAuth2生命周期。

快速开始

随着 uv （推荐）

# Install and run
uvx yattmcp serve

# Or clone and run from source
git clone https://github.com/mjkoo/yattmcp.git
cd yattmcp
uv run yattmcp serve

使用Docker

docker run -e TICKTICK_API_TOKEN=your-token ghcr.io/mjkoo/yattmcp:latest

Claude桌面配置

添加到您的Claude Desktop MCP配置中：

{
  "mcpServers": {
    "ticktick": {
      "command": "uvx",
      "args": ["yattmcp", "serve"],
      "env": {
        "TICKTICK_API_TOKEN": "your-token-here"
      }
    }
  }
}

环境变量

A. .env 工作目录中的文件会自动加载。

运输选项

yattmcp serve                              # stdio (default, for Claude Desktop)
yattmcp serve --transport streamable-http  # HTTP streaming
yattmcp serve --transport sse              # Server-sent events
yattmcp serve --transport http             # Plain HTTP
yattmcp serve --host 0.0.0.0 --port 8080  # Bind to specific host/port

9工具

发展

需要Python 3.14+和 紫外线.

uv sync                  # Install dependencies
uv run pytest            # Run tests
uv run ruff check .      # Lint
uv run ruff format .     # Format
uv run mypy src/         # Type check (strict mode)