顺序故事 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 编码标准以提高代码可读性。

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