Servidor MCP de historia secuencial

Un servidor de Protocolo de Contexto Modelo (MCP) para el Pensamiento Secuencial y la Historia Secuencial 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:

Historia Secuencial : Un enfoque narrativo para el pensamiento secuencial. En lugar de rastrear pensamientos abstractos, estructura los problemas como elementos narrativos con personajes, escenarios y desarrollos argumentales para hacerlos más memorables y atractivos.
Pensamiento secuencial : un puerto Python puro de la implementación de JavaScript, que elimina las dependencias de Node.js

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

Características

Historia secuencial

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

Pensamiento secuencial

Estructurar los problemas como una secuencia de pensamientos
Revisar o ramificar las vías de pensamiento según sea necesario
Generar y verificar hipótesis de solución
Seguimiento de la finalización del proceso de pensamiento
Implementación de Python puro (no se requiere Node.js)

Características comunes

Visualización formateada y codificada por colores de elementos
Compatibilidad total con el protocolo MCP para la integración con sistemas de IA
Soporte para ramificación y revisión

Instalación

Durante el desarrollo

Al trabajar 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 el escritorio de Claude para usar la herramienta con uvx agregando esto a tu Claude mcpServers.json:

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

La variable de entorno TOOLS controla qué herramientas están habilitadas. De forma predeterminada, solo está habilitada la herramienta Historia Secuencial, pero se puede agregar la herramienta Pensamiento Secuencial según sea necesario.

Esto es útil cuando desea centrarse en un enfoque específico para la resolución de problemas o al integrarse con otras herramientas MCP. También puede 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 a marcos analíticos y narrativos para mejorar la memoria y la resolución de problemas.

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

Sequential Story MCP Server