thinkstep

thinkstep

循序思考，大声说出想法，并由服务端串联整个过程。

有些问题无法一次解决。你先形成一个想法，试着推敲，发现第二步与第一步相矛盾，于是回头检查，从更早的节点尝试另一条路径，最后才看清答案的轮廓。thinkstep 是记录这一过程的笔记本：它是一个 MCP 服务，包含一个工具 sequentialthinking，可以逐步记录思路链，并为你理清完整历史记录，包括修订和分支思路。

每次调用都会添加一个想法。你需要说明当前进度（thoughtNumber）、估计还需要多少步（totalThoughts），以及是否需要继续。如果思路链超出预估，服务端会自动调高总步数，而不是报错。如果某一步重新审视了早先的想法，请将其标记为修订，并指出被重新审视的想法。若想探索不同路径，又不丢失主线，可以从早先的某个想法分出一个命名分支；每次响应都会列出迄今创建的分支 ID，让你随时了解哪些思路线仍在进行。

会话期间，状态保存在服务端进程中。不会写入磁盘，也不会离开本机；关闭会话即关闭笔记本。

使用方法

MCP 服务

npx @reneturcios/thinkstep mcp

MCP 客户端配置：

{
  "mcpServers": {
    "thinkstep": {
      "command": "npx",
      "args": ["-y", "@reneturcios/thinkstep", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/thinkstep          # stdio MCP server (default command is "mcp")
docker run --rm ghcr.io/cloudcorprecords/thinkstep --version

工具

sequentialthinking

记录一个思考步骤，并获取思路链的摘要。

参数	类型	必填	含义
thought	string	是	当前思考步骤
nextThoughtNeeded	boolean	是	是否需要继续思考
thoughtNumber	integer	是	当前思考编号（数值，例如 1、2、3）
totalThoughts	integer	是	预计所需的思考总数（数值，例如 5、10）
isRevision	boolean	否	是否修订了先前的想法
revisesThought	integer	否	正在重新审视的想法编号
branchFromThought	integer	否	分支起点的想法编号
branchId	string	否	分支标识符
needsMoreThoughts	boolean	否	是否还需要更多思考

如果某个想法同时包含 branchFromThought 和 branchId，就会跟踪该分支。修订会通过 isRevision: true 记录，并将 revisesThought 设为被重新审视的想法编号；原始想法仍会保留在历史记录中。

每个被接受的想法都会返回一份 JSON 摘要：

{
  "thoughtNumber": 2,
  "totalThoughts": 5,
  "nextThoughtNeeded": true,
  "branches": ["cheaper-route"],
  "thoughtHistoryLength": 4
}

• thoughtNumber / totalThoughts — 当前思路链的进度。如果 thoughtNumber 大于预估的 totalThoughts，总数会自动调高至 thoughtNumber。
• nextThoughtNeeded — 思路链是否继续。发送 needsMoreThoughts: true 时，该字段也会返回 true。
• branches — 迄今创建的所有分支 ID，按创建顺序排列。
• thoughtHistoryLength — 服务端记录的想法数量，包括当前这条。

缺失或类型错误的字段会导致调用被拒绝，并返回一条指明问题字段的错误结果（isError）；被拒绝的调用不会记录任何内容。

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts
npm run dev     # run the CLI from source

许可证

MIT — 参见 LICENSE。