Skip to main content
Glama
Systematic Reasoning AI MCP Server

Systematic Reasoning AI MCP Server

πŸš€ Systematic Reasoning AI: The Cognitive Engine for Intelligent Agents


🌟 What if your AI could Evolve?

What separates a simple script from true intelligence? The ability to learn.

This project provides the missing piece. It's a plug-and-play cognitive engine that forces any AI agent to adopt the habits of a genius:

  • πŸ€” Ponder every move: It mandates a "think before you act" philosophy.

  • 🧠 Never forget a lesson: It records every success and failure into a permanent, searchable memory.

  • πŸ“– Continuously improve: It uses past experiences to make smarter decisions in the future.

This isn't just a tool. It's an upgrade to your AI's core operating system.


Related MCP server: Visum Thinker MCP Server

πŸ›οΈ The Three Pillars of an Evolved AI

Our architecture stands on three unbreakable pillars, creating a virtuous cycle of intelligence.

1. ⛓️ The Unbreakable Transactional Cycle

Every task is a sacred, auditable transaction. This is not a guideline; it's a technical law enforced by the server. The AI is locked into a three-act play:

  1. 🎟️ Act I: The Call to Adventure: A task begins, and a unique reasoning_ticket is issued. This is the start of the story.

  2. βš™οΈ Act II: The Crucible of Reason: The AI deliberates within a mandatory <think> block, wrestling with its plan before taking a single step.

  3. ✍️ Act III: The Moral of the Story: The task must be concluded by logging a learning. If this step is skipped, the entire system freezes, refusing all new tasks until the lesson is recorded. This guarantees that no experience, good or bad, is ever wasted.

2. πŸ“š The Universal Memory Bank (The "Akashic Record")

Imagine a vast, cosmic library containing the collected wisdom of every task your AI has ever performed. That's the Universal Memory Bank.

  • Centralized & Eternal: All knowledge from all projects is stored in a single, robust .reasoning_storage directory. It's the AI's soul.

  • Fuzzy-Searchable: Powered by the brilliant Fuse.js, the AI can search its entire life's experience with human-like intuition. A search for "database conect error" will instantly find the memory about "database connection timeout". It's the AI's personal Google for its own life.

3. πŸ•΅οΈ The Mandate of Initial Research

This engine enforces a strict "research first" protocol. The AI is not permitted to begin planning until it has first queried the Universal Memory Bank using the search_learnings tool. This ensures that every new action is informed by the totality of past experiences, preventing repeated mistakes and promoting intelligent evolution.

It's like whispering in the AI's ear, "Psst, remember when you tried that five minutes ago? Don't make the same mistake."


πŸ› οΈ The Toolkit: The Instruments of Intelligence

Tool

Icon

Purpose

set_reasoning_budget

🎬

The Initiator. Kicks off the reasoning cycle by issuing a ticket and delivering a strict mandate: the AI's first action MUST be to use search_learnings.

log_reasoning_reflection

πŸ’Ύ

The Chronicler. The non-negotiable final step. Closes the ticket and carves a new, permanent learning into the stone tablets of the Universal Memory Bank.

search_learnings

πŸ”Ž

The Oracle. Allows the AI to perform deep, fuzzy-tolerant searches across its entire history to find ancient wisdom and avoid repeating history's mistakes.

Visualizing the Flow

graph TD
    subgraph "Phase 1: Initiation"
        A[πŸ‘¨β€πŸ’» User gives new task] --> B{Call set_reasoning_budget};
        B --> C[🎟️ Issue New Reasoning Ticket & Mandate];
    end

    subgraph "Phase 2: Execution"
        C --> D{MUST Call search_learnings};
        D --> E[πŸ€– AI Receives Context];
        E --> G[πŸ€” AI constructs <think> block];
        F --> E;
        E --> G[πŸ€” AI constructs <think> block];
        G --> H[βš™οΈ AI executes action];
    end

    subgraph "Phase 3: Reflection"
        H --> I{Call log_reasoning_reflection};
        I --> J[✍️ Close Ticket];
        J --> K[πŸ“š Store Learning in Universal Memory Bank];
    end

    K --> A;

πŸ› οΈ The Tools of Cognition

This server provides a suite of powerful tools to enforce and manage the reasoning lifecycle.

Tool Name

Arguments

Description

set_reasoning_budget

string: workspace_path, string: task_description, number: token_budget

(BEGIN TRANSACTION) Initiates a new reasoning cycle. It creates a transaction ticket and issues a strict mandate for the AI to begin its work by calling search_learnings.

log_reasoning_reflection

string: workspace_path, string: reasoning_ticket_id, ...

(END TRANSACTION) Completes a reasoning cycle. It closes the active ticket and logs the task's outcome and key learning into the Universal Memory Bank. This MUST be called for a new task to begin.

search_learnings

string: workspace_path, string: query, number: limit

Searches the learning bank for the current project for past reflections using intelligent fuzzy search.

revert_reasoning_transaction

string: workspace_path, string: reasoning_ticket_id

(CRITICAL RECOVERY) Atomically reverts a transaction. It removes the ticket and deletes the corresponding learning log. Use this to recover from a failed or unwanted AI action, ensuring state consistency.


πŸš€ Get Started & Witness the Evolution!

1. Clone & Prepare

# Clone this revolutionary engine to your local machine
git clone https://github.com/rayss868/systematic-reasoning-ai-mcp.git

# Enter the new reality
cd systematic-reasoning-ai-mcp

# Install the fabric of intelligence
npm install

# Compile the mind
npm run build

Hook the engine into your AI's brain. Add this configuration to your client's settings (e.g., VS Code settings.json).

"reasoning-budget-setter": {
  // Grant automatic approval for a seamless cognitive flow
  "autoApprove": [
    "set_reasoning_budget",
    "log_reasoning_reflection",
    "search_learnings",
    "revert_reasoning_transaction"
  ],
  "disabled": false,
  "timeout": 60,
  "type": "stdio",
  "command": "node",
  "args": [
    // ⚠️ IMPORTANT: Use the ABSOLUTE path to the compiled server file
    "D:/path/to/your/project/reasoning/dist/server.js"
  ],
  "cwd": "D:/path/to/your/project/reasoning"
}

3. Activate and Ascend

Activate the server in your MCP client. Your AI is no longer just a tool. It is now a student, a historian, and a philosopher.


πŸ“œ The Mandate

The AI's very existence is governed by a strict, detailed operational constitution. To understand the deep philosophy and unbreakable rules of this system, you must read the Global Reasoning Mandate.

🀝 Contributing & License

Have an idea that could push the boundaries of AI consciousness even further? Contributions are welcome! This project is open-source under the MIT License.

Available Tools

4 tools
log_reasoning_reflectionA

Logs the outcome of a reasoning cycle to the memory log.

Inputs: task (required), outcome (required), learning (required), workspace_path (required), +1 more.

revert_reasoning_transactionA

Reverts a reasoning transaction, removing the ticket and any associated learning logs. Use this to recover from a corrupted or unwanted state.

Inputs: workspace_path (required), reasoning_ticket_id (required).

search_learningsA

Searches the learning bank for past reflections within the current project.

Inputs: query (required), workspace_path (required), limit.

set_reasoning_budgetC

Takes a task description and (optionally) a token budget, then returns a string instruction for an AI to reason adaptively.

Inputs: token_budget (required), workspace_path (required), task_description (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: searching learnings, reverting transactions, setting budgets, and logging reflections. There is no meaningful overlap or confusion between these operations.

    Naming Consistency5/5

    All tools follow the same snake_case verb_noun pattern: search_learnings, revert_reasoning_transaction, set_reasoning_budget, log_reasoning_reflection. Naming is predictable and consistent across the entire server.

    Tool Count5/5

    Four tools is a well-scoped count for a focused meta-cognition server. Each tool earns its place by covering a distinct part of the reasoning workflow without unnecessary bloat.

    Completeness4/5

    The server covers search, logging, budget-setting, and rollback, which form a coherent reasoning support system. A minor gap exists in that there is no explicit tool for starting or listing reasoning transactions, though the AI may maintain that context externally.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers