Chorvy Planner / 看板系统速览

在讲 MCP 化之前，先快速认识一下被改造的对象——我做的一款个人产品经理日程管理看板工具。

为什么要 MCP 化？

已经有 Web 界面了，为什么还要做一层 MCP Server？

打开浏览器 → 登录 → 点击新建
→ 填写标题 / 日期 / 优先级
→ 保存 → 重复以上步骤
→ 批量加 10 条任务 ≈ 5分钟

Claude Code ← "帮我加三条任务：
明天上午对齐需求，下午出原型，
后天写 PRD"
→ 3 秒搞定，自动推算日期

整体架构 / How It Works

MCP Server 作为中间层，在 Claude Code 和 Backend 之间建立了一条自然语言到数据库操作的通道。

数据模型的关键设计

7 个 MCP Tools

每个 Tool 对应一个原子操作，Claude Code 根据用户意图自动选择和编排调用。

核心实现细节

从鉴权到数据映射，几个值得关注的实现要点。

每次调用都鉴权

MCP Server 在每个 Tool 调用时都执行 signInWithPassword，确保拿到最新的 session。单行 JSON blob 的特性意味着每次操作是「读全量 → 改 → 写全量」。

// 每次 tool 调用的核心流程
async function withAuth(callback) {
  const { data } = await Backend.auth.signInWithPassword({
    email: CREDENTIALS.email,
    password: CREDENTIALS.password
  });

  // 读取整个 appData JSON blob
  const { data: rows } = await Backend
    .from('user_data')
    .select('content')
    .eq('user_id', data.user.id);

  const appData = rows[0].content;

  // 执行具体操作（增删改查）
  const result = await callback(appData);

  // 写回（如有修改）
  await Backend.from('user_data').upsert({
    user_id: data.user.id,
    content: appData
  }, { onConflict: 'user_id' });

  return result;
}

优先级标签映射

Web 端存储的是标签 ID（如 p_must、p_tentative），但用户通过 Claude 说的是自然语言（"紧急"、"可选"）。MCP Server 在读写两个方向都做了映射：

MCP SDK 接入

// package.json 核心依赖
{
  "dependencies": {
    "@modelcontextprotocol/sdk": "latest",
    "@Backend/Backend-js": "^2"
  }
}

// index.js 注册 Tool
server.setRequestHandler(ListToolsRequestSchema, () => ({
  tools: [
    {
      name: "list_tasks",
      description: "List tasks filtered by date/status/mode",
      inputSchema: { /* JSON Schema */ }
    },
    // ... 其余 6 个 Tool
  ]
}));

配置踩坑实录

MCP Server 写好只是第一步，让 Claude Code 正确加载它才是挑战。以下是实际遇到的坑。

🔴 坑 1：配置文件放错位置

🔴 坑 2：配置嵌套层级错误

检查 .claude.json 后发现，chorvy-planner 被放在了 projects["某路径"] 的嵌套对象里，而不是根级 mcpServers。这导致它只在特定项目上下文中可见。

{
  "mcpServers": {
    "notion": { ... }
  },
  "projects": {
    "E:\\任务管理": {
      "mcpServers": {
        "chorvy-planner": { ... }
      }
    }
  }
}

{
  "mcpServers": {
    "notion": { ... },
    "chorvy-planner": {
      "command": "node",
      "args": [
        "E:\\任务管理\\index.js"
      ]
    }
  }
}

🟡 坑 3：Windows 路径转义

🟢 不需要手动启动

配置完成后，不需要手动运行 node index.js 保持 MCP Server 在后台运行。Claude Code 会在需要时自动管理进程生命周期——启动、调用、关闭全部由 Claude Code 托管。

实际使用效果

配置完成后，在 Claude Code 终端中就可以用自然语言操控任务了。

场景 1：批量添加任务

# 用户在 Claude Code 中说：
> 帮我加几条任务：明天上午产品评审，下午跟设计对齐交互稿，
  后天写 Q2 规划 PRD

# Claude 自动：
→ 调用 batch_add_tasks
  - 推算 "明天" = 2026-03-20
  - 推算 "后天" = 2026-03-21
  - 默认优先级 p_must
  - 一次 Backend 读写完成

# 刷新 Web 看板，3 条任务已出现在正确的日期列中 ✓

场景 2：查询和分析

# 用户：
> 这周有哪些任务还没做完？

# Claude 调用 list_tasks，返回结构化数据后分析：
→ 调用 list_tasks { date: "this_week", status: "pending" }

本周还有 5 条未完成任务：
  1. 📋 Q2 规划 PRD (3/21, 必做) ← 明天截止
  2. 📋 竞品分析报告 (3/19, 必做) ← ⚠️ 今天，注意
  3. ...

# 用户：
> 帮我把竞品分析标记完成

→ 调用 complete_task { task_id: "mcp_1710..." }
✓ 已完成

场景 3：周报生成

# 用户：
> 帮我生成本周工作总结

→ 调用 weekly_summary { week_offset: 0 }

# 返回结构化数据：
{
  total: 18, completed: 12, pending: 6,
  completion_rate: "66.7%",
  overdue: ["竞品分析报告", "数据埋点文档"]
}

# Claude 基于数据生成自然语言周报

手机远程操控看板

最终形态：在手机上给飞书发一条消息，任务就自动出现在看板上。整条链路串联了 Week 2 的飞书 Skill 和 Week 3 的 MCP Server。

链路拆解

回顾与收获

把一个个人看板工具 MCP 化的完整过程，和从中学到的东西。

下一步可以做什么？