Pomodash MCP Server

PomoDash MCP服务器

一个模型上下文协议（MCP）服务器，将人工智能助手连接到PomoDash，以实现无缝的任务和项目管理。

特性

• 任务管理：使用创建、列出、更新和删除任务 PomoDash生产力应用程序
• Notes系统：创建和管理链接到任务/项目的笔记
• 类别和项目：用类别和项目组织你的工作
• 安全认证：具有速率限制的基于API密钥的身份验证
• Docker支持：使用Docker和Docker Compose轻松部署
• 人工智能集成：适用于所有MCP兼容客户端（Claude Desktop、VS Code、Cursor等）

先决条件

• 高级PomoDash账户：MCP集成需要高级订阅
• API密钥：在PomoDash设置中生成API密钥→ API密钥
• Node.js 20+ （用于当地发展）或 码头工人 （用于集装箱化部署）

Docker桌面快速入门

1.在PomoDash中生成API密钥

1. 打开PomoDash 在浏览器中登录
2. 导航到“设置” → 点击您的个人资料→ 设置
3. 转到API密钥部分 → 在设置菜单中查找“API密钥”
4. 点击“生成新密钥” → 这为MCP访问创建了一个新的API密钥
5. 立即复制密钥 → 格式如下 pmk_abc123...
6. ⚠️ 重要：您只能看到此密钥一次！把它保存在安全的地方。

2.设置环境文件

1. 下载此存储库 或将其克隆到您的计算机
2. 导航到pomodash mcp服务器文件夹
3. 查找文件 .env.example 在文件夹中
4. 备份 并将其重命名为 .env （删除.example部分）
5. 打开 .env 文件 使用任何文本编辑器（记事本、文本编辑、VS代码等）
6. 替换 pmk_your_api_key_here 使用步骤1中的实际API密钥
7. 保存文件

你的 .env 文件应该看起来像这样：

POMODASH_API_KEY=pmk_abc123your_real_key_here
POMODASH_API_URL=https://mcp.pomodash.mindsnapz.de
NODE_ENV=production

3.使用Docker桌面应用

选项A：使用Docker Compose（最简单）

1. 打开Docker桌面 计算机上的应用程序
2. 确保Docker桌面正在运行 （你会看到Docker鲸鱼图标）
3. 打开终端/命令提示符 并导航到pomodash mcp服务器文件夹
4. 运行命令: docker-compose up --build
5. 返回Docker桌面 → 您将看到一个名为“pomodash mcp服务器”的新容器
6. 容器现在正在运行！ 你可以看到日志，从Docker桌面停止/启动它

选项B：在Docker桌面中手动构建和运行

1. 打开Docker桌面 应用
2. 打开终端 并导航到pomodash mcp服务器文件夹
3. 塑造形象: docker build -t pomodash-mcp-server .
4. 转到Docker桌面 → “图像”选项卡→ 您将看到“pomodash mcp服务器”
5. 点击“运行”按钮 图像旁边
6. 在运行对话框中:

- 点击“可选设置” - 转到“环境变量” - 添加： POMODASH_API_KEY = your_api_key - 添加： POMODASH_API_URL = https://mcp.pomodash.mindsnapz.de - 选中“交互式”和“TTY”选项

1. 点击“运行” → 容器启动并出现在“容器”选项卡中

4.验证它是否正常工作

1. 在Docker桌面，转到“容器”选项卡
2. 查找“pomodash mcp服务器” 容器
3. 点击它 查看详细信息
4. 查看“日志”选项卡 → 应显示“PomoDash MCP服务器在stdio上运行”
5. 如果您看到错误，检查您的API密钥是否正确，您的PomoDash帐户是否为高级帐户

地方发展

设置

# Install dependencies
npm install

# Build TypeScript
npm run build

# Start in development mode
npm run dev

运行服务器

# With environment variables set
POMODASH_API_KEY=pmk_your_key node dist/index.js

# Or with .env file
npm start

MCP客户端配置

Docker配置（所有MCP客户端）

将以下内容添加到MCP客户端的配置文件中：

{
  "mcpServers": {
    "pomodash": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "POMODASH_API_KEY=pmk_your_api_key_here",
        "mcp/pomodash"
      ]
    }
  }
}

配置文件位置

克劳德桌面：

• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

其他MCP客户端：

• 大多数MCP客户端使用类似的JSON配置
• 检查客户的文档以了解确切的文件位置
• 上述配置格式普遍适用

替代方案：本地Node.js设置（无Docker）

如果你不想使用Docker：

1. 构建项目: npm run build 在pomodash mcp服务器文件夹中
2. 请改用此配置:

{
  "mcpServers": {
    "pomodash": {
      "command": "node",
      "args": ["/full/path/to/pomodash-mcp-server/dist/index.js"],
      "env": {
        "POMODASH_API_KEY": "pmk_your_api_key_here",
        "POMODASH_API_URL": "https://mcp.pomodash.mindsnapz.de"
      }
    }
  }
}

快速开始

使用Docker（推荐）

1. 生成PomoDash API密钥

- 打开 PomoDash → 设置→ API密钥 - 点击“生成新密钥”（需要高级帐户） - 复制密钥（格式： pmk_...)

1. 使用Docker运行

   docker run --rm -i \
     -e POMODASH_API_KEY=pmk_your_api_key_here \
     mcp/pomodash

1. 配置AI助手

- 添加到MCP客户端配置中（见下面的示例）

Docker桌面MCP工具包

如果您的Docker桌面启用了MCP工具包：

1. 在MCP目录中搜索“PomoDash”
2. 点击“安装”
3. 输入您的API密钥
4. 连接到您的AI助手

手动设置

可用工具

MCP服务器为AI助手提供以下工具：

任务

• create_task -创建新任务
• list_tasks -列出所有任务
• update_task -更新现有任务
• delete_task -删除任务
• create_task_for_project -创建链接到项目的任务

备注

• create_note -创建新笔记
• list_notes -列出所有笔记
• update_note -更新现有注释
• delete_note -删除注释

类别和项目

• list_categories -列出所有类别和项目
• create_category -创建新类别或项目

环境变量

测试

测试Docker构建

./test-docker.sh

手动测试

# Test API connection
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://mcp.pomodash.mindsnapz.de/tasks

# Test container health
docker ps
docker logs pomodash-mcp-server

故障排除

常见问题

“POMODASH_API_KEY环境变量是必需的”

• 确保您的 .env 文件包含有效的API密钥
• 检查密钥格式是否以开头 pmk_

“401无效的API密钥”

• 验证API密钥是否正确且处于活动状态
• 检查您的高级订阅是否处于活动状态

“需要403保费”

• 升级到高级PomoDash帐户
• 在帐户设置中验证您的订阅状态

“429超出速率限制”

• 您已达到每日API限值
• 等待每日重置或联系支持

容器无法启动

• 检查Docker日志： docker logs pomodash-mcp-server
• 验证 .env 文件存在并且包含有效值
• 确保Docker有足够的资源

Docker调试

# View container logs
docker-compose logs -f pomodash-mcp-server

# Check container status
docker-compose ps

# Rebuild from scratch
docker-compose down
docker-compose build --no-cache
docker-compose up

安全

• 永远不要提交API密钥 到版本控制
• 定期旋转按键 在 PomoDash 设置
• 使用环境变量 敏感数据
• 保持Docker镜像更新 用于安全补丁

什么是PomoDash？

PomoDash 是一个将番茄工作法与高级任务管理相结合的现代生产力应用程序。专为想要：

• 更专注：使用经过验证的番茄钟来保持注意力
• 组织任务：高级项目和类别管理
• 跟踪进度：详细的分析和生产力见解
• 保持动力：游戏化元素和条纹追踪
• 随时随地工作：跨平台实时同步

尝试PomoDash→

支持

关于以下问题：

• MCP服务器：检查此存储库的问题
• PomoDash应用程序：参观 PomoDash
• MCP协议：参见 模型上下文协议文档