Sequential Story

Servidor MCP de Sequential Story

Un servidor de Protocolo de Contexto de Modelo (MCP) para Sequential Thinking y Sequential Story como técnicas mnemotécnicas para la resolución de problemas.

Descripción general

Este proyecto ofrece dos herramientas MCP complementarias para estructurar problemas complejos:

1. Sequential Story - Un enfoque basado en narrativa para el pensamiento secuencial. En lugar de rastrear pensamientos abstractos, estructura problemas como elementos de historia con personajes, escenarios y desarrollos de trama para hacerlos más memorables y atractivos.

2. Sequential Thinking - Una implementación en Python puro del código JavaScript, eliminando las dependencias de Node.js

Ambos enfoques aprovechan el poder de la secuenciación y la estructura para mejorar la retención de memoria y la comprensión de problemas.

Características

Sequential Story

• Construir soluciones de problemas como secuencias narrativas
• Revisar y ramificar elementos de la historia según sea necesario
• Rastrear personajes, escenarios, tonos y puntos de la trama
• Visualización formateada y codificada por colores de los elementos de la historia

Sequential Thinking

• Estructurar problemas como una secuencia de pensamientos
• Revisar o ramificar rutas de pensamiento según sea necesario
• Generar y verificar hipótesis de solución
• Rastrear la finalización del proceso de pensamiento
• Implementación en Python puro (sin necesidad de Node.js)

Características comunes

• Visualización formateada y codificada por colores de los elementos
• Soporte completo del protocolo MCP para integración con sistemas de IA
• Soporte para ramificación y revisión

Instalación

Durante el desarrollo

Cuando se trabaja con el paquete localmente antes de publicar:

# Clone the repository
git clone https://github.com/dhkts1/sequentialStory
cd sequentialStory

# Install dependencies using uv
uv venv
source .venv/bin/activate
uv sync

# Install with development dependencies
uv sync --group dev

Instalación con MCP

# Install in the Claude desktop app
mcp install -e . src/cli.py -n "Sequential Story"

# Install with only the Sequential Thinking tool
mcp install -e . src/cli.py -n "Sequential Thinking" --env-var "TOOLS='[\"thinking\"]'"

# Install with only the Sequential Story tool explicitly
mcp install -e . src/cli.py -n "Sequential Story" --env-var "TOOLS='[\"story\"]'"

# Install with both tools
mcp install -e . src/cli.py -n "Sequential Tools" --env-var "TOOLS='[\"thinking\",\"story\"]'"

Para desarrollo:

# For development with the MCP Inspector
mcp dev src/__main__.py:main

También puedes configurar Claude desktop para usar la herramienta con uvx añadiendo esto a tu archivo mcpServers.json de Claude:

"mcpServers": {
  "Sequential Story": {
    "command": "uvx",
    "args": [
      "sequential-story"
    ]
  }
}

La variable de entorno TOOLS controla qué herramientas están habilitadas. Por defecto, solo la herramienta Sequential Story está habilitada, pero la herramienta Sequential Thinking se puede añadir según sea necesario.

Esto es útil cuando quieres centrarte en un enfoque específico de resolución de problemas o cuando te integras con otras herramientas MCP. También puedes actualizar las variables de entorno directamente en la aplicación de escritorio de Claude después de la instalación.

Ejemplo de elemento de historia

{
  "element": "Our protagonist, a data scientist named Alex, encounters a mysterious pattern in the customer behavior data.",
  "elementNumber": 1,
  "totalElements": 5,
  "nextElementNeeded": true,
  "character": "Alex (data scientist)",
  "setting": "Data analysis lab",
  "tone": "Mysterious",
  "plotPoint": "Discovery of pattern"
}

Ejemplo de elemento de pensamiento

{
  "thought": "The problem requires analyzing multiple data sources to identify correlations between customer behavior and sales patterns.",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true
}

Desarrollo

# Install pre-commit hooks
uv run pre-commit install

# Run all pre-commit checks
poe pre

Créditos

Este proyecto se basa en los conceptos de pensamiento secuencial y resolución estructurada de problemas, adaptando estos enfoques tanto a marcos analíticos como narrativos para mejorar la memoria y la resolución de problemas.

La implementación de Sequential Thinking es una adaptación en Python puro inspirada en la implementación de JavaScript de los repositorios del Protocolo de Contexto de Modelo: https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking