MAXential Thinking MCP

MAXential Thinking MCP

Un espacio de trabajo de razonamiento estructurado y persistente para IA. Proporciona 20 herramientas para construir cadenas de pensamiento, explorar alternativas mediante ramificaciones, revisar razonamientos anteriores, buscar en el historial de razonamiento y mantener sesiones a través de reinicios de ventana de contexto y reinicios del servidor.

El razonamiento integrado de la IA es efímero: cuando las ventanas de contexto se llenan, el pensamiento se comprime o se pierde. Los problemas complejos necesitan exploración de múltiples enfoques, retroceder cuando los caminos fallan y la capacidad de retomar donde lo dejaste. MAXential externaliza el razonamiento en un espacio de trabajo que persiste, se ramifica y sobrevive.

Origen

Bifurcado del servidor MCP de pensamiento secuencial de Anthropic, que proporcionaba una sola herramienta con 9 parámetros. Su esquema incluía parámetros de ramificación (branch_from_thought, branch_id) pero no tenía herramientas para crear, cambiar o gestionar ramas — los parámetros eran efectivamente inertes.

MAXential reemplazó esa única herramienta por completo y construyó 20 herramientas específicas en tres versiones:

Versión	Lo que se construyó
v2.0	Reemplazó la herramienta única con 11 herramientas enfocadas: pensamiento central (think, revise, complete), gestión completa de ramas (branch, switch_branch, list_branches, get_branch, close_branch, merge_branch) y navegación (get_thought, get_history)
v2.2	Añadió 5 herramientas de organización: tag, search, export, visualize, reset
v2.3	Añadió 4 herramientas de persistencia de sesión con almacenamiento SQLite: session_save, session_load, session_list, session_summary

Herramientas

Pensamiento Central

Herramienta	Qué hace
think	Añade un pensamiento a la cadena de razonamiento. Los pensamientos se numeran y persisten automáticamente.
revise	Revisa un pensamiento anterior cuando el razonamiento previo era defectuoso o incompleto. El original se conserva con historial de revisiones.
complete	Marca la cadena de pensamiento como completa con una conclusión final.
reset	Limpia la sesión actual y comienza de nuevo.

Ramificación

Herramienta	Qué hace
branch	Crea una nueva rama de razonamiento para explorar un camino alternativo sin perder el hilo principal.
switch_branch	Cambia el contexto a una rama diferente, o de vuelta a la principal.
list_branches	Lista todas las ramas con su estado y número de pensamientos.
get_branch	Recupera los detalles completos de una rama específica.
close_branch	Cierra una rama con una conclusión opcional.
merge_branch	Fusiona las ideas de una rama de vuelta a la principal. Estrategias: conclusion_only, full_integration, summary.

Navegación

Herramienta	Qué hace
get_thought	Recupera un pensamiento específico por su número.
get_history	Obtiene el historial de pensamientos, opcionalmente filtrado por rama.

Organización

Herramienta	Qué hace
tag	Añade o elimina etiquetas semánticas en un pensamiento (por ejemplo, hipótesis, evidencia, decisión, hallazgo).
search	Busca pensamientos por texto de contenido o por etiquetas.
export	Exporta la cadena de pensamiento como markdown o JSON.
visualize	Genera diagramas ASCII o Mermaid de la estructura de pensamientos y ramas.

Persistencia de Sesión

Herramienta	Qué hace
session_save	Nombra y describe la sesión actual para su recuperación posterior.
session_load	Restaura una sesión guardada — todos los pensamientos, ramas y etiquetas se cargan de vuelta en memoria.
session_list	Explora las sesiones disponibles, las más recientes primero.
session_summary	Genera un resumen comprimido de una sesión para una carga de contexto eficiente en tokens.

Las sesiones se persisten automáticamente en SQLite mientras trabajas. Cada llamada a think, branch, tag y revise escribe en disco en tiempo real. Las sesiones sobreviven a reinicios del servidor, reinicios de ventana de contexto y nuevas conversaciones — retoma donde lo dejaste.

Lo que proporciona el original vs. lo que proporciona MAXential

Capacidad	Anthropic sequential-thinking	MAXential Thinking
Interfaz	1 herramienta, 9 parámetros	20 herramientas enfocadas
Ramificación	Parámetros en el esquema, sin implementación	Ciclo de vida completo: crear, cambiar, listar, inspeccionar, fusionar, cerrar
Revisión	No soportada	Revisa cualquier pensamiento, el original se conserva con historial
Persistencia	Ninguna — se pierde al reiniciar el servidor	SQLite — sobrevive a reinicios, reinicios de contexto, nuevas conversaciones
Etiquetado	No soportado	Etiquetas semánticas en cualquier pensamiento
Búsqueda	No soportada	Búsqueda por contenido o etiquetas
Exportación	No soportada	Markdown, JSON, diagramas Mermaid, visualización ASCII
Navegación	No soportada	Recupera cualquier pensamiento por número, explora historial filtrado

Explorando el historial de sesiones

Los datos de sesión se almacenan en una base de datos SQLite estándar en .maxential/thinking.db. Hay varias formas de explorar sesiones de razonamiento pasadas:

A través de las propias herramientas — pide a la IA que use session_list para explorar sesiones, session_load para restaurar una, o session_summary para una vista general comprimida. La IA puede formatear, buscar y resumir el contenido de la sesión de forma conversacional.

Con un navegador SQLite — abre .maxential/thinking.db en cualquier visor SQLite (extensiones de VS Code/VSCodium, DB Browser for SQLite, o similar). El esquema es sencillo:

Tabla	Contiene
sessions	ID de sesión, nombre, descripción, estado, marcas de tiempo
thoughts	Cada pensamiento con su número, contenido, rama, enlaces de revisión
branches	Metadatos de rama, estado, conclusiones, historial de fusiones
tags	Etiquetas semánticas adjuntas a los pensamientos

Desde la terminal:

sqlite3 .maxential/thinking.db "SELECT name, status, datetime(created_at/1000, 'unixepoch', 'localtime') as created FROM sessions ORDER BY updated_at DESC LIMIT 10;"

Instalación

Claude Desktop / Claude Code

Añade a tu configuración de MCP:

Claude Desktop ubicación de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"]
    }
  }
}

Desde el código fuente

git clone https://github.com/BAM-DevCrew/MAXential-Thinking-MCP.git
cd MAXential-Thinking-MCP
npm install
npm run build

Luego configura:

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "node",
      "args": ["/path/to/MAXential-Thinking-MCP/dist/src/index.js"]
    }
  }
}

Configuración

Persistencia

Los datos de sesión se almacenan en SQLite. Por defecto, la base de datos se crea en .maxential/thinking.db en el directorio de trabajo.

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"],
      "env": {
        "MAXENTIAL_DB_PATH": "/path/to/your/thinking.db"
      }
    }
  }
}

Valor de MAXENTIAL_DB_PATH	Comportamiento
(no establecido)	.maxential/thinking.db en el directorio de trabajo
/path/to/file.db	Usar ruta de archivo explícita
:memory:	Solo en memoria — sin persistencia entre reinicios

Si la inicialización de SQLite falla (permisos, problemas con módulos nativos), el servidor vuelve automáticamente al modo en memoria — nunca se bloquea.

Añade .maxential/ al .gitignore de tu proyecto para mantener los datos de sesión fuera del control de versiones.

Registro

{
  "mcpServers": {
    "maxential-thinking": {
      "command": "npx",
      "args": ["-y", "@bam-devcrew/maxential-thinking-mcp"],
      "env": {
        "MAXENTIAL_LOG_FILE": "/path/to/error.log"
      }
    }
  }
}

Uso

No llamas a estas herramientas directamente — pides a tu IA que use el pensamiento MAXential, y ella llama a las herramientas como parte de su razonamiento. Aquí hay ejemplos de cómo se ve eso en la práctica.

Trabajando en una decisión:

usa maxential thinking para esto - ¿deberíamos usar REST o GraphQL para la nueva API?

La IA construye una cadena de pensamiento analizando la pregunta, se ramifica para explorar cada enfoque por separado, añade pensamientos con compensaciones, fusiona los hallazgos y llega a una conclusión. Todo el proceso de razonamiento está numerado, estructurado y persistido.

Explorando múltiples enfoques:

piensa en el rediseño de autenticación usando maxential - quiero ver ramas para JWT, tokens de sesión y OAuth

La IA crea tres ramas, razona a través de cada enfoque de forma independiente, y luego fusiona las ideas para comparar. Puedes pedirle que cambie entre ramas, cierre callejones sin salida, o profundice en un camino específico.

Reanudando pensamientos anteriores:

carga esa sesión donde analizaste nuestras opciones de optimización de base de datos

La IA explora las sesiones guardadas, encuentra la coincidencia, la restaura con todos los pensamientos, ramas y etiquetas intactos, y continúa razonando desde donde lo dejó — incluso entre diferentes conversaciones.

Revisando razonamientos pasados:

busca en tu historial de maxential thinking cualquier cosa etiquetada como decisión

La IA busca entre los pensamientos etiquetados de la sesión y devuelve los resultados. También puedes pedirle que exporte la cadena completa como markdown, o que genere un diagrama de la estructura de pensamientos.

Obteniendo un resumen rápido:

dame un resumen de esa sesión - solo los hallazgos clave, mantenlo corto

La IA genera un resumen comprimido de las conclusiones de la sesión, los aspectos destacados etiquetados y los resultados de las ramas — útil para cargar contexto sin reproducir toda la cadena.

Desarrollo

npm install          # Install dependencies
npm run build        # Build TypeScript
npm run watch        # Watch mode
npm test             # Run tests with coverage
npm run test:unit    # Unit tests only
npm run test:integration  # Integration tests only

Licencia

MIT

Contribuciones

Los problemas y solicitudes de extracción son bienvenidos en github.com/BAM-DevCrew/MAXential-Thinking-MCP