Plan And Act MCP

计划和实施MCP

计划、审查、运行！\ 为任何LLM带来Cursor的规划能力。

特性

• 基于会话的架构 --每个代理都有一个具有唯一NanoID的隔离工作区
• 草稿本 --基于文档的笔记和推理轨迹工作记忆
• 任务清单 --用于任务跟踪的原子CRUD操作
• X-User-ID安全 --适用于多用户环境的可选标头绑定（兼容LibreChat）
• TONL/JSON编码 --令牌高效响应格式（减少30-60%）
• 存储后端 --内存（默认）或Redis用于分布式部署
• TTL清理 --自动会话过期

快速入门（Docker）

使用Redis持久化运行的最快方法：

docker compose up -d

这将从GHCR中提取公共映像，并使用Redis启动MCP服务器。

终点：

• MCP： http://localhost:3000/mcp
• 健康： http://localhost:3000/health

发展

本地开发

npm install
npm run dev

Redis开发

在本地开发时使用Docker for Redis：

# Start Redis only
docker compose up -d redis

# Run server locally connecting to Redis
STORAGE_TYPE=redis npm run dev

Docker开发构建

使用Docker在本地构建和运行：

# Build local image
docker build -t mcp-scratchpad-todo .

# Run with docker-compose.dev.yml (builds from source)
docker compose -f docker-compose.dev.yml up -d

配置

创建一个 .env 文件或设置环境变量：

可用工具

所有工具都需要 session_id （除 init_session).

示例：结构化研究代理

You do web research for a User.

**CRITICAL:**
At start of an interaction: 
1. init_session
2. write startup todos
Never stop with execution until all todos are done.

**Todos:**
1. Clarify requirements with user → write specs to scratchpad
2. Perform research based on specs
3. perform youtube search about talk shows and discussed points on the research topic
4. get 3 transcripts of the discussions to get detailed talking points
5. Output results in agreed format and sources. include talking points from the people in the talkshow

**Scratchpad:** Store user requirements, track search relevance, draft output before presenting. Review scratchpad before final delivery to ensure alignment with original specs.

You are now being connected with a user.

集成

克劳德代码

添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "scratchpad-todo": {
      "type": "url",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Librechat

添加到 librechat.yaml:

mcp:
  scratchpad-todo:
    url: http://localhost:3000/mcp
    headers:
      X-User-ID: "{{LIBRECHAT_USER_ID}}"

光标

添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "scratchpad-todo": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

X-User-ID安全

对于多用户环境，请通过 X-User-ID 将会话绑定到用户的header：

• 会话已创建 和 X-User-ID 要求所有后续请求使用相同的标头
• 会话已创建 没有 它没有标头验证（向后兼容）

TONL格式

TONL（令牌优化表示法语言）将令牌使用量减少了30-60%。启用 RESPONSE_FORMAT=tonl.

TONL中的待办事项列表示例：

[2]{id, title, status, tags}
abc123   Task 1   done      [backend]
def456   Task 2   pending   []

存储后端

测试

npm test           # Run tests
npm run test:watch # Watch mode

归因

灵感来自 计划和行动 纸张 和 Cursor的计划模式

许可证

麻省理工学院