https://github.com/jacaudi/critical-thinking
MCP server for critical, narrated, sequential thinking
https://github.com/jacaudi/critical-thinking
critical-thinking mcp renovate sequential-thinking streamable-http-transport
Last synced: 5 days ago
JSON representation
MCP server for critical, narrated, sequential thinking
- Host: GitHub
- URL: https://github.com/jacaudi/critical-thinking
- Owner: jacaudi
- License: mit
- Created: 2025-09-22T00:20:13.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-06-10T15:16:59.000Z (7 days ago)
- Last Synced: 2026-06-10T16:24:48.061Z (7 days ago)
- Topics: critical-thinking, mcp, renovate, sequential-thinking, streamable-http-transport
- Language: Go
- Homepage:
- Size: 299 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Critical Thinking
A Model Context Protocol server for **critical, narrated, sequential thinking**. Think one step at a time, out loud — with required confidence calibration and adversarial self-critique on every thought.
It fuses three disciplines:
1. **Sequential thinking** — break problems into ordered, numbered steps; revise; branch.
2. **Thinking out loud** — explain each thought in first-person, exploratory voice. Putting half-formed reasoning into words is itself the double-check on it.
3. **Critical self-examination** — every thought is paired with confidence, assumptions, critique, and a counter-argument.
The single tool is `criticalthinking`. Every call must include the four critical-thinking fields — there is no opt-out, by design.
**Install & usage → [docs/usage.md](docs/usage.md).** One-line install:
```bash
go install github.com/jacaudi/critical-thinking/cmd/critical-thinking@latest
```
## One-call example
Request:
```json
{
"thought": "I think we should normalize first because reads dominate writes.",
"thoughtNumber": 1, "totalThoughts": 3, "nextThoughtNeeded": true,
"confidence": 0.6,
"assumptions": ["read:write ratio is ~10:1"],
"critique": "Drifted into solution mode without confirming the ratio.",
"counterArgument": "If writes dominate, monolith-first is simpler.",
"nextStepRationale": "Verify the read:write ratio before committing to normalization."
}
```
Response (`structuredContent`):
```json
{ "branches": [], "thoughtHistoryLength": 1, "sessionConfidence": 0.6 }
```
The `text` content is a rendered transcript in first-person, exploratory voice. Subsequent calls can omit `thoughtNumber` (auto-assigned) and `totalThoughts` (inherited). Keep each field to one tight sentence — the tool description asks for that brevity; the server does not enforce a hard limit. The full contract lives in the tool description itself.
## Resources
The server exposes `thinking://current` — a per-session JSON snapshot of the full thought history (trunk + branches, all critical-thinking fields preserved).
## Documentation
- [docs/usage.md](docs/usage.md) — install, MCP-server & CLI-pipe usage, a worked session
- [Install](docs/usage.md#install) · [As an MCP server](docs/usage.md#as-an-mcp-server) · [As a CLI pipe](docs/usage.md#as-a-cli-pipe-no-mcp-host) · [Worked session](docs/usage.md#a-worked-session)
- [docs/clients.md](docs/clients.md) — Claude Desktop, Codex CLI, VS Code, Cursor recipes
- [docs/configuration.md](docs/configuration.md) — env vars, HTTP endpoints, [logging](docs/configuration.md#logging), CORS, session lifecycle
- [docs/migration.md](docs/migration.md) — breaking changes since `http-sequential-thinking`
- [docs/development.md](docs/development.md) — building, testing, debugging with MCP Inspector
## License
[MIT](LICENSE).