English Français العربية

io.github.CloudCorpRecords/thinkstep

Registre officiel Autres

Step-by-step reflective thinking: record, revise, and branch thought chains.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @reneturcios/thinkstep
Claude Code 
claude mcp add thinkstep -- npx -y @reneturcios/thinkstep@0.1.0 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "thinkstep": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/thinkstep@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/thinkstep:0.1.0
Claude Code 
claude mcp add thinkstep -- docker run -i --rm ghcr.io/cloudcorprecords/thinkstep:0.1.0 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "thinkstep": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/thinkstep:0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. thinkstep
  2. Usage
  3. The tool
  4. Development
  5. License

thinkstep

Think in steps, out loud, with a server keeping the thread.

Some problems do not yield to a single pass. You form a first idea, poke at it, realise the second step contradicts the first, double back, try a different route from an earlier point, and only then see the shape of the answer. thinkstep is the notebook for that process: an MCP server with one tool, sequentialthinking, that records a chain of thoughts one step at a time and keeps the whole history — revisions and side branches included — straight for you.

Each call adds one thought. You say where you are (thoughtNumber), roughly how far you think you have to go (totalThoughts), and whether you need another step. If the chain outgrows your estimate, the server raises the total for you instead of complaining. When a step rethinks an earlier one, flag it as a revision and point at the thought it reconsiders. When you want to explore a different route without losing the main line, fork a named branch from an earlier thought; every response lists the branch ids created so far, so you always know which threads are open.

State lives in the server process for the length of the session. Nothing is written to disk, nothing leaves the machine, and closing the session closes the notebook.

Usage

MCP server
npx @reneturcios/thinkstep mcp

MCP client config:

{
  "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

The tool

sequentialthinking

Record one thinking step and get back a summary of the chain.

parametertyperequiredmeaning
thoughtstringyesYour current thinking step
nextThoughtNeededbooleanyesWhether another thought step is needed
thoughtNumberintegeryesCurrent thought number (numeric value, e.g., 1, 2, 3)
totalThoughtsintegeryesEstimated total thoughts needed (numeric value, e.g., 5, 10)
isRevisionbooleannoWhether this revises a previous thought
revisesThoughtintegernoWhich thought is being reconsidered
branchFromThoughtintegernoBranching point thought number
branchIdstringnoBranch identifier
needsMoreThoughtsbooleannoIf more thoughts are needed

A branch is tracked when a thought carries both branchFromThought and branchId. A revision is recorded with isRevision: true and revisesThought set to the number of the thought it rethinks; the original stays in the history.

Every accepted thought returns a JSON summary:

{
  "thoughtNumber": 2,
  "totalThoughts": 5,
  "nextThoughtNeeded": true,
  "branches": ["cheaper-route"],
  "thoughtHistoryLength": 4
}
  • thoughtNumber / totalThoughts — where the chain stands. If thoughtNumber exceeds the estimated totalThoughts, the total is raised to thoughtNumber.
  • nextThoughtNeeded — whether the chain continues. Sending needsMoreThoughts: true also reports this as true.
  • branches — the id of every branch created so far, in creation order.
  • thoughtHistoryLength — how many thoughts the server has recorded, including this one.

Missing or mistyped fields are refused with an error result (isError) naming the offending field; nothing is recorded for a rejected call.

Development

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

License

MIT — see LICENSE.

Questions fréquentes

Qu'est-ce que io.github.CloudCorpRecords/thinkstep ?

Step-by-step reflective thinking: record, revise, and branch thought chains.

Comment installer io.github.CloudCorpRecords/thinkstep ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add thinkstep -- npx -y @reneturcios/thinkstep@0.1.0 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.CloudCorpRecords/thinkstep ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.CloudCorpRecords/thinkstep est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.CloudCorpRecords/thinkstep ?

Il est publié par CloudCorpRecords. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.