MAXential Thinking MCP

MAXential Thinking MCP

Um espaço de trabalho de raciocínio estruturado e persistente para IA. Fornece 20 ferramentas para construir cadeias de pensamento, explorar alternativas por meio de ramificações, revisar raciocínios anteriores, pesquisar histórico de raciocínio e persistir sessões entre redefinições de janela de contexto e reinicializações do servidor.

O raciocínio integrado da IA é efêmero — quando as janelas de contexto se enchem, o pensamento é comprimido ou perdido. Problemas complexos exigem exploração de múltiplas abordagens, retrocesso quando caminhos falham e a capacidade de retomar de onde parou. O MAXential externaliza o raciocínio para um espaço de trabalho que persiste, ramifica e sobrevive.

Origem

Derivado do servidor MCP de pensamento sequencial da Anthropic, que fornecia uma única ferramenta com 9 parâmetros. Seu esquema incluía parâmetros de ramificação (branch_from_thought, branch_id), mas não tinha ferramentas para criar, alternar ou gerenciar ramificações — os parâmetros eram efetivamente inertes.

O MAXential substituiu essa única ferramenta completamente e construiu 20 ferramentas específicas em três versões:

Versão	O que foi construído
v2.0	Substituiu a ferramenta única por 11 ferramentas focadas: pensamento central (think, revise, complete), gerenciamento completo de ramificações (branch, switch_branch, list_branches, get_branch, close_branch, merge_branch) e navegação (get_thought, get_history)
v2.2	Adicionou 5 ferramentas de organização: tag, search, export, visualize, reset
v2.3	Adicionou 4 ferramentas de persistência de sessão com armazenamento SQLite: session_save, session_load, session_list, session_summary

Ferramentas

Pensamento Central

Ferramenta	O que faz
think	Adiciona um pensamento à cadeia de raciocínio. Os pensamentos são numerados e persistidos automaticamente.
revise	Revisa um pensamento anterior quando o raciocínio anterior estava falho ou incompleto. O original é preservado com histórico de revisão.
complete	Marca a cadeia de pensamento como completa com uma conclusão final.
reset	Limpa a sessão atual e começa do zero.

Ramificação

Ferramenta	O que faz
branch	Cria uma nova ramificação de raciocínio para explorar um caminho alternativo sem perder o fluxo principal.
switch_branch	Alterna o contexto para uma ramificação diferente, ou de volta para a principal.
list_branches	Lista todas as ramificações com seu status e contagem de pensamentos.
get_branch	Recupera detalhes completos de uma ramificação específica.
close_branch	Fecha uma ramificação com uma conclusão opcional.
merge_branch	Mescla insights de uma ramificação de volta para a principal. Estratégias: conclusion_only, full_integration, summary.

Navegação

Ferramenta	O que faz
get_thought	Recupera um pensamento específico pelo seu número.
get_history	Obtém o histórico de pensamentos, opcionalmente filtrado por ramificação.

Organização

Ferramenta	O que faz
tag	Adiciona ou remove tags semânticas em um pensamento (ex.: hipótese, evidência, decisão, descoberta).
search	Pesquisa pensamentos por texto de conteúdo ou por tags.
export	Exporta a cadeia de pensamento como markdown ou JSON.
visualize	Gera diagramas ASCII ou Mermaid da estrutura de pensamentos e ramificações.

Persistência de Sessão

Ferramenta	O que faz
session_save	Nomeia e descreve a sessão atual para recuperação posterior.
session_load	Restaura uma sessão salva — todos os pensamentos, ramificações e tags são carregados de volta na memória.
session_list	Navega pelas sessões disponíveis, mais recentemente atualizadas primeiro.
session_summary	Gera um resumo compactado de uma sessão para carregamento de contexto eficiente em tokens.

As sessões são persistidas automaticamente no SQLite enquanto você trabalha. Cada chamada de think, branch, tag e revise grava no disco em tempo real. As sessões sobrevivem a reinicializações do servidor, redefinições de janela de contexto e novas conversas — retome de onde parou.

O que o original fornece vs. o que o MAXential fornece

Capacidade	Anthropic sequential-thinking	MAXential Thinking
Interface	1 ferramenta, 9 parâmetros	20 ferramentas focadas
Ramificação	Parâmetros no esquema, sem implementação	Ciclo de vida completo: criar, alternar, listar, inspecionar, mesclar, fechar
Revisão	Não suportado	Revise qualquer pensamento, original preservado com histórico
Persistência	Nenhuma — perdida na reinicialização do servidor	SQLite — sobrevive a reinicializações, redefinições de contexto, novas conversas
Marcação	Não suportado	Tags semânticas em qualquer pensamento
Pesquisa	Não suportado	Pesquisa por conteúdo ou tags
Exportação	Não suportado	Markdown, JSON, diagramas Mermaid, visualização ASCII
Navegação	Não suportado	Recupere qualquer pensamento por número, navegue pelo histórico filtrado

Navegando pelo histórico de sessões

Os dados da sessão são armazenados em um banco de dados SQLite padrão em .maxential/thinking.db. Existem várias maneiras de navegar por sessões de raciocínio anteriores:

Através das próprias ferramentas — peça à IA para usar session_list para navegar pelas sessões, session_load para restaurar uma, ou session_summary para uma visão geral compactada. A IA pode formatar, pesquisar e resumir o conteúdo da sessão de forma conversacional.

Com um navegador SQLite — abra .maxential/thinking.db em qualquer visualizador SQLite (extensões do VS Code/VSCodium, DB Browser for SQLite ou similar). O esquema é direto:

Tabela	Contém
sessions	ID da sessão, nome, descrição, status, carimbos de data/hora
thoughts	Cada pensamento com seu número, conteúdo, ramificação, links de revisão
branches	Metadados da ramificação, status, conclusões, histórico de mesclagem
tags	Tags semânticas anexadas aos pensamentos

Do 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;"

Instalação

Claude Desktop / Claude Code

Adicione à sua configuração MCP:

Claude Desktop localização do config:

• 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"]
    }
  }
}

A partir do código-fonte

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

Em seguida, configure:

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

Configuração

Persistência

Os dados da sessão são armazenados em SQLite. Por padrão, o banco de dados é criado em .maxential/thinking.db no diretório de trabalho.

{
  "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	Comportamento
(não definido)	.maxential/thinking.db no diretório de trabalho
/path/to/file.db	Usar caminho de arquivo explícito
:memory:	Somente em memória — sem persistência entre reinicializações

Se a inicialização do SQLite falhar (permissões, problemas com módulos nativos), o servidor volta automaticamente para o modo em memória — ele nunca trava.

Adicione .maxential/ ao .gitignore do seu projeto para manter os dados da sessão fora do controle de versão.

Registro de Logs

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

Uso

Você não chama essas ferramentas diretamente — você pede à sua IA para usar o pensamento MAXential, e ela chama as ferramentas como parte do seu raciocínio. Aqui estão exemplos do que isso parece na prática.

Trabalhando em uma decisão:

use maxential thinking para isso — devemos usar REST ou GraphQL para a nova API?

A IA constrói uma cadeia de pensamento analisando a questão, ramifica para explorar cada abordagem separadamente, adiciona pensamentos com trade-offs, mescla as descobertas e chega a uma conclusão. Todo o processo de raciocínio é numerado, estruturado e persistido.

Explorando múltiplas abordagens:

pense sobre o redesenho de autenticação usando maxential — quero ver ramificações para JWT, tokens de sessão e OAuth

A IA cria três ramificações, raciocina sobre cada abordagem independentemente e depois mescla os insights para comparar. Você pode pedir para alternar entre ramificações, fechar becos sem saída ou aprofundar em um caminho específico.

Retomando pensamentos anteriores:

carregue aquela sessão em que você analisou nossas opções de otimização de banco de dados

A IA navega pelas sessões salvas, encontra a correspondência, restaura com todos os pensamentos, ramificações e tags intactos, e continua o raciocínio de onde parou — mesmo entre conversas diferentes.

Revisando raciocínios passados:

pesquise no seu histórico de maxential thinking por qualquer coisa marcada como decisão

A IA pesquisa nos pensamentos marcados da sessão e retorna os resultados. Você também pode pedir para exportar a cadeia completa como markdown, ou gerar um diagrama da estrutura de pensamentos.

Obtendo um resumo rápido:

me dê um resumo daquela sessão — apenas os principais achados, seja breve

A IA gera um resumo compactado das conclusões da sessão, destaques marcados e resultados das ramificações — útil para carregar contexto sem reproduzir a cadeia completa.

Desenvolvimento

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

Licença

MIT

Contribuição

Issues e PRs são bem-vindos em github.com/BAM-DevCrew/MAXential-Thinking-MCP