Sequential Story

🚀 顺序故事 MCP 服务器

本项目是一个用于结构化复杂问题解决的模型上下文协议（MCP）服务器，它巧妙结合了序贯思维和顺序故事这两种助记术技术，为解决复杂问题提供了创新且高效的途径。

🚀 快速开始

此项目提供了两种互补的 MCP 工具来解决问题：

1. 顺序故事：这是一种基于叙述的序贯思维方法。它不跟踪抽象思想，而是将问题结构化为故事情节中的元素，涵盖角色、场景和情节发展，让问题更易记忆且更具吸引力。
2. 顺序思维：这是纯 Python 实现的 JavaScript 版本，消除了对 Node.js 的依赖。

两种方法均借助序列和结构的力量，来增强记忆保留和对问题的理解。

✨ 主要特性

顺序故事

• 可将解决方案构建为叙述序列。
• 能根据需求修订或分支故事情节。
• 可跟踪角色、场景、语气和情节点。
• 能对故事元素进行格式化、颜色编码显示。

顺序思维

• 可将问题结构化为思想的序列。
• 能根据需求修订或分支思考路径。
• 可生成并验证解决方案假设。
• 能跟踪思考过程的完成情况。
• 采用纯 Python 实现，无需 Node.js。

共同功能

• 对元素进行格式化、颜色编码显示。
• 完全支持 MCP 协议，可实现与其他 AI 系统的集成。
• 支持分支和修订。

📦 安装指南

在开发期间

在发布前本地工作时：

# 克隆仓库
git clone https://github.com/dhkts1/sequentialStory
cd sequentialStory

# 安装依赖项使用 uv
uv venv
source .venv/bin/activate
uv sync

# 带有开发依赖项的安装
uv sync --group dev

使用 MCP 安装

# 在 Claude 桌面应用中安装
mcp install -e . src/cli.py -n "顺序故事"

# 只安装顺序思维工具
mcp install -e . src/cli.py -n "顺序思维" --env-var "TOOLS='[\"thinking\"]'"

# 明确仅安装顺序故事工具
mcp install -e . src/cli.py -n "顺序故事" --env-var "TOOLS='[\"story\"]'"

# 安装两者
mcp install -e . src/cli.py -n "顺序工具" --env-var "TOOLS='[\"thinking\",\"story\"]'"

用于开发：

# 使用 MCP 检查器进行开发
mcp dev src/__main__.py:main

你还可以通过在 Claude 的 mcpServers.json 中添加以下内容，配置 Claude 桌面使用该工具：

"mcpServers": {
  "顺序故事": {
    "command": "uvx",
    "args": [
      "sequential-story"
    ]
  }
}

环境变量 TOOLS 可控制启用的工具。默认情况下，仅启用顺序故事工具，但可按需添加顺序思维工具。这在希望专注于特定问题解决方法或与其他 MCP 工具集成时非常有用。你也可以在 Claude 桌面应用安装后直接更新环境变量。

💻 使用示例

基础用法

示例故事元素

{
  "element": "我们的主角，数据科学家 Alex，在客户行为数据中发现了一个神秘的模式。",
  "elementNumber": 1,
  "totalElements": 5,
  "scene": "在安静的数据中心内，Alex 专注于复杂的图表和数字流。",
  "tone": "紧张和好奇",
  "plotTwist": "这个模式预示着即将发生的重要事件。"
}

示例思考元素

{
  "thought": "我需要分析这些数据以确定模式的原因。",
  "analysis": "初步检查显示与用户行为相关。",
  "nextStep": "进一步研究可能的解释。",
  "uncertainty": "我不确定是否所有因素都被考虑在内。",
  "confidenceLevel": "中等自信"
}

高级用法

1. 安装依赖项：确保你已经安装了 Python 和 pip。然后运行 pip install -r requirements.txt。
2. 配置环境变量（可选）：根据需要设置 TOOLS 环境变量以启用特定功能。
3. 运行工具：
   • 对于顺序故事，使用 python src/story_generator.py
   • 对于顺序思维，使用 python src/thinker.py
4. 输入交互：按照提示输入你的查询或问题。

📚 详细文档

注意事项

• 保持代码库清洁和可维护。
• 定期测试功能以确保正常工作。
• 遵循 PEP8 编码标准以提高代码可读性。

这个项目展示了如何将叙事和技术结合，提供一种创新的方法来解决复杂的问题。