Think Tool

Melhora o raciocínio da IA ao fornecer um ambiente de pensamento estruturado.

GitHub
6

Documentação

Ferramenta de Reflexão MCP

Um servidor Model Context Protocol (MCP) que fornece uma ferramenta de "reflexão" para assistentes de IA criarem checkpoints cognitivos e raciocínio estruturado. Esta ferramenta ajuda LLMs a manter contexto, refletir sobre seu trabalho e pensar através de problemas complexos de forma sistemática.

Por que usar esta ferramenta?

Insight-chave: Sem a saída explícita de processos de pensamento, nenhum pensamento profundo ocorre. Esta ferramenta cria checkpoints cognitivos obrigatórios que previnem atalhos e melhoram a precisão.

Recursos

  • 🧠 Raciocínio Estruturado: Força assistentes de IA a refletir passo a passo através de problemas complexos
  • ✅ Validação de Tarefas: Cria checkpoints para verificar se os requisitos são atendidos
  • 📝 Documentação de Aprendizado: Captura descobertas e insights durante a resolução de problemas
  • 🔍 Auxílio de Depuração: Ajuda a trabalhar através de problemas sistematicamente por eliminação
  • 🎯 Trilha de Auditoria de Decisões: Cria um registro de raciocínio para decisões importantes

Instalação

Instalação Rápida via NPM

# Install globally
npm install -g mcp-reflection-tool

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

Integração com Ferramentas de IA

Claude Code

Adicione o servidor usando um único comando:

mcp add npx mcp-reflection-tool

Isso configurará automaticamente o servidor nas configurações do seu Claude Code. Após executar o comando, reinicie o Claude Code completamente.

Cursor

Adicione à sua configuração do Cursor:

Opção 1: Via Interface de Configurações

  1. Abra as Configurações do Cursor (Cmd/Ctrl + ,)
  2. Pesquise por "MCP" ou navegue até Features > MCP
  3. Adicione a configuração da ferramenta de reflexão

Opção 2: Edição Direta do Config

Edite ~/.cursor/mcp_config.json:

{
  "mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

Reinicie o Cursor após fazer as alterações.

Windsurf

Adicione à sua configuração MCP do Windsurf:

Localização: ~/.windsurf/mcp.json (macOS/Linux) ou %USERPROFILE%\.windsurf\mcp.json (Windows)

{
  "mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

Reinicie o Windsurf para aplicar as alterações.

Cline (Extensão VS Code)

Opção 1: Via Interface de Configurações do VS Code

  1. Abra as Configurações do VS Code (Cmd/Ctrl + ,)
  2. Pesquise por "Cline MCP"
  3. Adicione a configuração do servidor

Opção 2: Editar settings.json

Adicione ao seu settings.json do VS Code:

{
  "cline.mcpServers": {
    "reflection-tool": {
      "command": "npx",
      "args": ["mcp-reflection-tool"]
    }
  }
}

Recarregue a janela do VS Code após a configuração.

Alternativa: Modo de Servidor Manual

O servidor roda via stdio por padrão. Se você precisar do modo HTTP, use variáveis de ambiente:

# Start server in stdio mode (default)
npx mcp-reflection-tool

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

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

A maioria das ferramentas modernas de IA suporta o modo stdio automaticamente.

Exemplos de Uso

Uma vez instalado, o assistente de IA terá acesso à ferramenta reflect. Aqui estão exemplos de como ela é usada:

Antes de Ações Complexas

Using reflection tool: "Breaking down authentication implementation:
1. Check existing auth patterns in codebase
2. Set up JWT token generation  
3. Add middleware for route protection
4. Test with valid and expired tokens"

Após Completar Tarefas

Using reflection tool: "Task completion check:
- Completed: Implemented user authentication with JWT
- Learned: Existing middleware made integration smooth
- Technical debt: Need to add rate limiting
- Next: Update API documentation"

Durante a Resolução de Problemas

Using reflection tool: "Debugging slow API responses:
- Symptom: 5+ second response times
- Hypothesis 1: Missing database indexes - CONFIRMED
- Hypothesis 2: N+1 query problem - Also found
- Solution: Added compound indexes and query batching
- Result: Response time now <200ms"

Quando a Ferramenta é Usada

O assistente de IA usará automaticamente esta ferramenta como um rascunho cognitivo para:

  • 🔍 Raciocínio em cadeia de pensamento através de problemas complexos
  • 📋 Planejando sua abordagem antes de tomar ações
  • ✅ Refletindo sobre resultados após completar tarefas
  • ✔️ Validando que os requisitos são atendidos
  • 📝 Documentando descobertas e aprendizados
  • 🎯 Criando checkpoints cognitivos que você não pode pular

Isso ajuda a IA a pensar passo a passo, melhorando a precisão e conformidade.

Desenvolvimento

Pré-requisitos

  • Node.js 18+ ou runtime Bun
  • npm ou gerenciador de pacotes bun

Configuração

# Clone the repository
git clone https://github.com/sterling/think-tool.git
cd think-tool

# Install dependencies
bun install
# or
npm install

# Run in development mode (with hot-reload)
bun run dev
# or
npm run dev

Compilando a partir do Código Fonte

# Build TypeScript to JavaScript
bun run build
# or
npm run build

# Run the built version
bun start
# or
npm start

Estrutura do Projeto

├── src/
│   └── server.ts      # TypeScript source code
├── dist/              # Built JavaScript (generated)
│   ├── server.js      # Main server file
│   └── cli.js         # CLI executable
├── package.json       # NPM package configuration
└── tsconfig.json      # TypeScript configuration

Configuração

Variáveis de Ambiente

  • PORT: Porta do servidor (padrão: 8080) 
    PORT=3000 npx mcp-reflection-tool

Como Funciona

A ferramenta de reflexão implementa o Model Context Protocol (MCP) para fornecer uma maneira padronizada de assistentes de IA acessarem ferramentas externas. Quando um assistente de IA precisa refletir sobre um problema:

  1. A IA chama a ferramenta reflect com seu raciocínio
  2. A ferramenta registra o processo de pensamento no console do servidor
  3. A ferramenta reconhece o checkpoint de volta para a IA
  4. Isso cria um checkpoint cognitivo que melhora a qualidade do raciocínio

Este efeito de "pensar em voz alta" demonstrou melhorar significativamente a precisão e completude das respostas de IA.

Solução de Problemas

Problemas Comuns

Porta Já em Uso

# Use a different port
PORT=8081 npx mcp-reflection-tool

Permissão Negada

# Reinstall globally with proper permissions
sudo npm install -g mcp-reflection-tool

Ferramenta Não Disponível no Assistente de IA

  1. Certifique-se de que o servidor MCP está rodando
  2. Reinicie sua ferramenta de IA após adicionar a configuração
  3. Verifique se há sintaxe JSON válida nos arquivos de configuração
  4. Verifique a localização do arquivo de configuração para seu sistema operacional

Verificando Logs

  • Logs do servidor: Visíveis no terminal onde o servidor está rodando
  • Logs do Claude Code: ~/Library/Logs/Claude/mcp*.log (macOS)
  • Logs do VS Code: View > Output > Selecione "Cline" no menu suspenso
  • Logs do Cursor: Help > Toggle Developer Tools > Console

Verificando a Instalação

# Check if package is installed globally
npm list -g mcp-reflection-tool

# Test the server directly
npx mcp-reflection-tool

# Test stdio mode
echo '{"jsonrpc":"2.0","method":"initialize","id":1}' | npx mcp-reflection-tool

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie seu branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Envie para o branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Licença

Licença MIT - veja o arquivo LICENSE para detalhes.

Autor

Criado como uma implementação MCP para melhorar as capacidades de raciocínio de IA.

Links

Agradecimentos

  • Construído com o framework FastMCP
  • Implementa o padrão Model Context Protocol
  • Inspirado por pesquisas sobre raciocínio estruturado para sistemas de IA