Think Tool

Provides a cognitive reflection tool that logs checkpoints, validates requirements, and documents insights for AI planning.

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fourcolors-think-tool": {
      "command": "npx",
      "args": [
        "mcp-reflection-tool"
      ],
      "env": {
        "HTTP": "true",
        "PORT": "8080"
      }
    }
  }
}

You can use the Reflection Tool MCP server to create structured cognitive checkpoints as you solve problems. It guides you through reasoning step-by-step, validates that you’ve met requirements, and documents discoveries and learnings to improve accuracy and accountability.

How to use

You interact with the Reflection Tool through an MCP client. After you initiate a reflective session, you provide your reasoning prompts to the tool, which records a cognitive checkpoint, checks that you’ve addressed each requirement, and returns an acknowledgment. Use it before tackling complex tasks to plan your approach, during work to track progress, and after completion to audit outcomes and decisions.

How to install

Prerequisites: ensure you have Node.js 18+ installed, and a package manager such as npm or bun.

# Install the Reflection Tool globally
npm install -g mcp-reflection-tool

# Or run directly with npx (no installation needed)
npx mcp-reflection-tool

Additional setup and notes

To run the tool in standard local (stdio) mode, use the following command. This runs a local server that your MCP clients can connect to directly through the stdio interface.

npx mcp-reflection-tool

Configuration and troubleshooting

You can enable HTTP mode if you need an HTTP endpoint. Start the tool with HTTP enabled and an optional port to listen on. If you run into port conflicts, choose a different port.

# Start in HTTP mode on port 8080
HTTP=true npx mcp-reflection-tool

# Start in HTTP mode on a custom port
HTTP=true PORT=3000 npx mcp-reflection-tool

Usage examples

Before starting complex work, you can articulate a plan like: Breaking down authentication implementation:

Check existing patterns
Set up token generation
Add middleware for protection
Test with various tokens.

After completing tasks, you might summarize outcomes and lessons learned: Task completion check: Completed: Implemented JWT authentication; Learned: Middleware integration was smooth; Next: Add rate limiting.

Notes on reflections and checkpoints

Use the tool to create a trace of your decision-making and debugging steps. This helps you validate requirements and keeps a record of insights for future work.

Available tools

reflect

Offers structured reasoning by producing cognitive checkpoints, validating requirements, documenting findings, and auditing decisions during problem solving.