Think Tool

Herramienta de Reflexión MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una herramienta de "reflexión" para asistentes de IA con el fin de crear puntos de control cognitivos y razonamiento estructurado. Esta herramienta ayuda a los LLM a mantener el contexto, reflexionar sobre su trabajo y pensar en problemas complejos de manera sistemática.

¿Por qué usar esta herramienta?

Idea clave: Sin expresar explícitamente los procesos de pensamiento, no ocurre un pensamiento profundo. Esta herramienta crea puntos de control cognitivos obligatorios que previenen atajos y mejoran la precisión.

Características

• 🧠 Razonamiento estructurado: Obliga a los asistentes de IA a reflexionar paso a paso sobre problemas complejos
• ✅ Validación de tareas: Crea puntos de control para verificar que se cumplan los requisitos
• 📝 Documentación de aprendizaje: Captura descubrimientos e ideas durante la resolución de problemas
• 🔍 Ayuda de depuración: Ayuda a trabajar los problemas sistemáticamente por eliminación
• 🎯 Rastro de auditoría de decisiones: Crea un registro del razonamiento para decisiones importantes

Instalación

Instalación rápida vía NPM

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

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

Integración con herramientas de IA

Claude Code

Agrega el servidor usando un solo comando:

mcp add npx mcp-reflection-tool

Esto configurará automáticamente el servidor en la configuración de Claude Code. Después de ejecutar el comando, reinicia Claude Code por completo.

Cursor

Agrega a tu configuración de Cursor:

Opción 1: Vía interfaz de configuración

1. Abre la configuración de Cursor (Cmd/Ctrl + ,)
2. Busca "MCP" o navega a Features > MCP
3. Agrega la configuración de la herramienta de reflexión

Opción 2: Edición directa de configuración

Edita ~/.cursor/mcp_config.json:

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

Reinicia Cursor después de hacer los cambios.

Windsurf

Agrega a tu configuración MCP de Windsurf:

Ubicación: ~/.windsurf/mcp.json (macOS/Linux) o %USERPROFILE%\.windsurf\mcp.json (Windows)

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

Reinicia Windsurf para aplicar los cambios.

Cline (Extensión de VS Code)

Opción 1: Vía interfaz de configuración de VS Code

1. Abre la configuración de VS Code (Cmd/Ctrl + ,)
2. Busca "Cline MCP"
3. Agrega la configuración del servidor

Opción 2: Editar settings.json

Agrega a tu settings.json de VS Code:

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

Recarga la ventana de VS Code después de la configuración.

Alternativa: Modo de servidor manual

El servidor se ejecuta vía stdio por defecto. Si necesitas modo HTTP, usa variables de entorno:

# 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

La mayoría de las herramientas de IA modernas soportan el modo stdio automáticamente.

Ejemplos de uso

Una vez instalado, el asistente de IA tendrá acceso a la herramienta reflect. Aquí hay ejemplos de cómo se usa:

Antes de acciones complejas

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"

Después de completar tareas

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 la resolución 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"

Cuándo se usa la herramienta

El asistente de IA usará automáticamente esta herramienta como un bloc de notas cognitivo para:

• 🔍 Razonamiento en cadena de pensamiento a través de problemas complejos
• 📋 Planificar tu enfoque antes de tomar acciones
• ✅ Reflexionar sobre los resultados después de completar tareas
• ✔️ Validar que se cumplan los requisitos
• 📝 Documentar descubrimientos y aprendizajes
• 🎯 Crear puntos de control cognitivos que no puedes omitir

Esto ayuda a la IA a pensar paso a paso, mejorando la precisión y el cumplimiento.

Desarrollo

Requisitos previos

• Node.js 18+ o runtime de Bun
• npm o gestor de paquetes de bun

Configuración

# 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

Compilar desde el código fuente

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

# Run the built version
bun start
# or
npm start

Estructura del proyecto

├── 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

Configuración

Variables de entorno

• PORT: Puerto del servidor (predeterminado: 8080)

  PORT=3000 npx mcp-reflection-tool
  

Cómo funciona

La herramienta de reflexión implementa el Protocolo de Contexto de Modelo (MCP) para proporcionar una forma estandarizada de que los asistentes de IA accedan a herramientas externas. Cuando un asistente de IA necesita reflexionar sobre un problema:

1. La IA llama a la herramienta reflect con su razonamiento
2. La herramienta registra el proceso de pensamiento en la consola del servidor
3. La herramienta reconoce el punto de control de vuelta a la IA
4. Esto crea un punto de control cognitivo que mejora la calidad del razonamiento

Se ha demostrado que este efecto de "pensar en voz alta" mejora significativamente la precisión y la integridad de las respuestas de IA.

Solución de problemas

Problemas comunes

Puerto ya en uso

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

Permiso denegado

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

Herramienta no disponible en el asistente de IA

1. Asegúrate de que el servidor MCP esté ejecutándose
2. Reinicia tu herramienta de IA después de agregar la configuración
3. Verifica la sintaxis JSON válida en los archivos de configuración
4. Verifica la ubicación del archivo de configuración para tu sistema operativo

Revisión de registros

• Registros del servidor: Visibles en la terminal donde se ejecuta el servidor
• Registros de Claude Code: ~/Library/Logs/Claude/mcp*.log (macOS)
• Registros de VS Code: Ver > Salida > Selecciona "Cline" del menú desplegable
• Registros de Cursor: Ayuda > Alternar herramientas de desarrollador > Consola

Verificación de la instalación

# 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

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción.

1. Haz un fork del repositorio
2. Crea tu rama de características (git checkout -b feature/amazing-feature)
3. Haz commit de tus cambios (git commit -m 'Add amazing feature')
4. Haz push a la rama (git push origin feature/amazing-feature)
5. Abre una Solicitud de Extracción

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

Autor

Creado como una implementación de MCP para mejorar las capacidades de razonamiento de la IA.

Enlaces

• Paquete NPM
• Repositorio de GitHub
• Documentación del Protocolo de Contexto de Modelo
• Reportar problemas

Agradecimientos

• Construido con el framework FastMCP
• Implementa el estándar Protocolo de Contexto de Modelo
• Inspirado en investigaciones sobre razonamiento estructurado para sistemas de IA