Todocko MCP Server

Todocko MCP服务器

英文版本如下 / 跳转到英语

MCP（Model Context Protocol）数据处理服务器 托多奇科 AI助理应用程序

支持

• 克劳德桌面版 全面支持
• 克劳德代码（CLI） 完全支持（相同配置）

要求

• Node.js 18+
• 使用 Evolu 同步数据的 Todocko 帐户

安装

1. 下载

使用 Git：

git clone https://github.com/brnt-cz/todocko-mcp.git
cd todocko-mcp

或者下载 ZIP z 发布 和展开。

2. 运行安装程序

Linux/macOS：

chmod +x install.sh
./install.sh

Windows（PowerShell）：

.\install.ps1

安装程序 ：

1. 安装依赖关系并构建项目
2. 询问您是否要配置 Claude Desktop、Claude Code 或两者兼而有之
3. 创建占位符配置文件
4. 手动填充 您的24字备份短语到配置文件
5. 重新启动 Claude

手动安装

1. 安装依赖关系：

   npm install
   npm run build

1. 添加到配置：

克劳德桌面版 (~/.config/Claude/claude_desktop_config.json 在 Linux 或 ~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上：

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/cesta/k/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "vaše 24slovná zálohovací fráze"
      }
    }
  }
}

克劳德代码（CLI） 添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/cesta/k/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "vaše 24slovná zálohovací fráze"
      }
    }
  }
}

1. 重新启动 Claude Desktop / Claude Code

可用工具 （86）

项目

作业

用户

工作原理

附件

评论

清单

提及（Mentions）

任务之间的链接

标签

任务模板

Kanban 列

已保存的视图

Aktivita

项目备注

部署阶段

存储库链接

共享项目

分析和概述

诊断

应用范例

项目列表

Zobraz mi seznam všech projektů v Todocko

任务列表

Jaké mám úkoly ve stavu "todo"?
Zobraz úkoly projektu TODO

任务细节

Jaké jsou detaily úkolu TODO-15?

创建任务

Vytvoř nový úkol v projektu PROJ s názvem "Opravit bug v přihlášení" a prioritou high
Vytvoř úkol s deadline na 2026-03-15 a scheduledDate na 2026-03-10

更新任务

Označ úkol PROJ-5 jako dokončený
Přiřaď úkol TODO-10 uživateli s ID xyz
Nastav scheduledDate úkolu TODO-10 na zítra

时间记录

Zaloguj 2 hodiny práce na úkol TODO-15 s popisem "Implementace feature"

与附件的工作

Nahraj soubor /home/user/report.pdf jako přílohu k úkolu TODO-15
Jaké přílohy má úkol TODO-15?
Smaž přílohu s ID xyz

共享项目

Zobraz sdílené projekty
Jaké úkoly jsou ve sdíleném projektu?
Označ úkol jako nasazený na produkci

部署阶段

Jaké deployment stages má projekt?
Vytvoř novou deployment stage "Staging" pro sdílený projekt

子任务

Vytvoř sub-úkol k úkolu TODO-15 v projektu TODO
Odpoj úkol TODO-20 od rodičovského úkolu (parentTaskId: null)

概述和分析

Jaký mám dnes přehled? (dashboard summary)
Jak je vytížený tým tento týden?
Jaké úkoly jsou po termínu?
Zobraz úkoly naplánované na příští týden
Analyzuj závislosti v projektu TODO
Jaké mám opakující se úkoly?

安全

重要信息： 您的备份短语是敏感数据！

• 永远不要与AI直接对话
• 在MCP服务器配置中，短语是安全的（AI无法访问它）
• 任何使用您的短语的人都可以完全访问您的数据

数据位置

数据库存储在目录中 ~/.todocko/:

文件 ：

• todocko.db 您的个人信息（任务、项目）
• todocko-shared.db 共享项目

更改配置

克劳德代码（CLI）

更改配置后，在 ~/.claude/settings.json （例如，改变记忆体）运行命令：

/mcp

这样，MCP 服务器将重新启动。

切换到其他帐户

当记忆体更改为 其他 Todocko 帐户 需要删除本地数据库：

# Linux/macOS
rm ~/.todocko/todocko.db

# Windows
del %USERPROFILE%\.todocko\todocko.db

该数据库包含以前记忆体的所有者 ID。删除后，下次启动时将创建新数据库并下载新帐户的数据。

故障排除

服务器无法启动

• 请确保您有 Node.js 18+
• 检查您是否已启动 npm run build
• 在 Claude Desktop 中检查日志

数据无法同步

• 检查备份短语是否正确（24字）
• 检查互联网连接
• 等待几秒钟进行同步
• 尝试删除 ~/.todocko/todocko.db 并重新启动

工具不可见

• 重新启动 Claude Desktop
• 在 Claude Code 中使用 /mcp pro重新加载
• 检查配置文件
• 检查 dist/index.js 的路径

发展

# Instalace závislostí
npm install

# Build
npm run build

# Watch mode pro vývoj
npm run dev

# Ruční spuštění
TODOCKO_MNEMONIC="vaše fráze" npm start

______________________________________________________________________

英语

用于工作的MCP（模型上下文协议）服务器 托多奇科 来自AI助手的应用程序数据。

支持

• 克劳德桌面版 -全力支持
• 克劳德代码（CLI） -完全支持（相同配置）

需求

• Node.js 18+
• Todokko帐户，数据通过Evolu同步

安装

1.下载

使用git：

git clone https://github.com/brnt-cz/todocko-mcp.git
cd todocko-mcp

或下载ZIP 从 发布 并提取。

2.运行安装程序

Linux/macOS：

chmod +x install.sh
./install.sh

Windows（PowerShell）：

.\install.ps1

安装程序将：

1. 安装依赖项并构建项目
2. 询问是否配置Claude Desktop、Claude Code或两者都配置
3. 创建带有占位符的配置文件
4. 手动添加 将24个单词的备份短语添加到配置文件中
5. 重新启动克劳德

手动安装

1. 安装依赖项：

   npm install
   npm run build

1. 添加到配置：

克劳德桌面版 (~/.config/Claude/claude_desktop_config.json 在Linux或 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "your 24 word backup phrase"
      }
    }
  }
}

克劳德代码（CLI） -添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "todocko": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "TODOCKO_MNEMONIC": "your 24 word backup phrase"
      }
    }
  }
}

1. 重新启动克劳德桌面/Claude代码

可用工具（86）

项目

任务

用户

工作日志

附件

评论

清单

提及

任务链接

标签

任务模板

看板栏

保存的视图

活动日志

项目笔记

部署阶段

存储库链接

共享项目

分析和报告

诊断

用法示例

列出项目

Show me all projects in Todocko

列出任务

What tasks do I have with status "todo"?
Show tasks for project TODO

任务详细信息

What are the details of task TODO-15?

创建任务

Create a new task in project PROJ with title "Fix login bug" and priority high
Create a task with deadline 2026-03-15 and scheduledDate 2026-03-10

更新任务

Mark task PROJ-5 as completed
Assign task TODO-10 to user with ID xyz
Set scheduledDate of task TODO-10 to tomorrow

记录时间

Log 2 hours of work on task TODO-15 with description "Feature implementation"

使用附件

Upload file /home/user/report.pdf as attachment to task TODO-15
What attachments does task TODO-15 have?
Delete attachment with ID xyz

共享项目

Show shared projects
What tasks are in the shared project?
Mark task as deployed to production

部署阶段

What deployment stages does the project have?
Create a new deployment stage "Staging" for the shared project

子任务

Create a sub-task for task TODO-15 in project TODO
Detach task TODO-20 from its parent (parentTaskId: null)

分析和报告

What's my dashboard summary for today?
How is the team's workload this week?
What tasks are overdue?
Show tasks scheduled for next week
Analyze dependencies in project TODO
What recurring tasks do I have?

安全

重要提示： 您的备份短语（助记符）是敏感数据！

• 永远不要在与AI的对话中直接分享它
• 在MCP服务器配置中，短语是安全的（AI无法访问它）
• 任何有你短语的人都可以完全访问你的数据

数据位置

数据库存储在 ~/.todocko/ 目录：

文件夹：

• todocko.db -您的个人数据（任务、项目）
• todocko-shared.db -共享项目

配置更改

克劳德代码（CLI）

在更改配置后 ~/.claude/settings.json （例如，更改助记符），运行以下命令：

/mcp

这将使用新配置重新启动MCP服务器。

切换到其他帐户

当将助记符更改为 不同的Todoko帐户，您需要删除本地数据库：

# Linux/macOS
rm ~/.todocko/todocko.db

# Windows
del %USERPROFILE%\.todocko\todocko.db

数据库包含前一个助记符中的所有者ID。删除后，将在下次启动时创建一个新的数据库，并下载新帐户的数据。

故障排除

服务器无法启动

• 检查你是否有Node.js 18+
• 检查你是否跑过 npm run build
• 在Claude Desktop中检查日志

数据未同步

• 验证备份短语是否正确（24个单词）
• 检查网络连接
• 等待几秒钟进行同步
• 尝试删除 ~/.todocko/todocko.db 并重新启动

工具不可见

• 重新启动克劳德桌面
• 在克劳德代码中，使用 /mcp 用于重新加载
• 检查配置文件
• 检查dist/index.js的路径

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Manual run
TODOCKO_MNEMONIC="your phrase" npm start