Sequential Story

Servidor MCP Sequential Story

Um servidor Model Context Protocol (MCP) para Sequential Thinking e Sequential Story como técnicas mnemônicas para resolução de problemas.

Visão Geral

Este projeto oferece duas ferramentas MCP complementares para estruturar problemas complexos:

1. Sequential Story - Uma abordagem baseada em narrativa para o pensamento sequencial. Em vez de rastrear pensamentos abstratos, ele estrutura problemas como elementos de história com personagens, cenários e desenvolvimentos de enredo para torná-los mais memoráveis e envolventes.

2. Sequential Thinking - Uma implementação pura em Python da versão JavaScript, eliminando dependências do Node.js

Ambas as abordagens aproveitam o poder da sequenciação e da estrutura para melhorar a retenção de memória e a compreensão de problemas.

Recursos

Sequential Story

• Construir soluções de problemas como sequências narrativas
• Revisar e ramificar elementos da história conforme necessário
• Rastrear personagens, cenários, tons e pontos do enredo
• Exibição formatada e codificada por cores dos elementos da história

Sequential Thinking

• Estruturar problemas como uma sequência de pensamentos
• Revisar ou ramificar caminhos de pensamento conforme necessário
• Gerar e verificar hipóteses de solução
• Rastrear a conclusão do processo de pensamento
• Implementação pura em Python (sem necessidade de Node.js)

Recursos Comuns

• Exibição formatada e codificada por cores dos elementos
• Suporte completo ao protocolo MCP para integração com sistemas de IA
• Suporte para ramificação e revisão

Instalação

Durante o Desenvolvimento

Ao trabalhar com o pacote localmente antes da publicação:

# 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

Instalando com 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 desenvolvimento:

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

Você também pode configurar o Claude desktop para usar a ferramenta com uvx adicionando isto ao seu mcpServers.json do Claude:

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

A variável de ambiente TOOLS controla quais ferramentas estão habilitadas. Por padrão, apenas a ferramenta Sequential Story está habilitada, mas a ferramenta Sequential Thinking pode ser adicionada conforme necessário.

Isso é útil quando você deseja focar em uma abordagem específica de resolução de problemas ou ao integrar com outras ferramentas MCP. Você também pode atualizar as variáveis de ambiente diretamente no aplicativo de desktop do Claude após a instalação.

Exemplo de elemento de história

{
  "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"
}

Exemplo de elemento de pensamento

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

Desenvolvimento

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

# Run all pre-commit checks
poe pre

Créditos

Este projeto se baseia nos conceitos de pensamento sequencial e resolução estruturada de problemas, adaptando essas abordagens para estruturas analíticas e narrativas para melhorar a memória e a resolução de problemas.

A implementação do Sequential Thinking é uma porta pura em Python inspirada na implementação JavaScript dos repositórios Model Context Protocol: https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking