顺序故事 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\"]'"

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

对于开发：

# 使用MCP Inspector进行开发
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,
  "nextElementNeeded": true,
  "character": "Alex（数据科学家）",
  "setting": "数据分析实验室",
  "tone": "神秘",
  "plotPoint": "发现模式"
}

示例思考元素

{
  "thought": "这个问题需要分析多个数据源，以识别客户行为与销售模式之间的相关性。",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true
}

开发

# 安装pre-commit钩子
uv run pre-commit install

# 运行所有pre-commit检查
poe pre

致谢

本项目基于顺序思维和结构化问题解决的概念，将这些方法适应到分析和叙述框架中，以增强记忆和问题解决能力。

顺序思维的实现是受Model Context Protocol存储库中的JavaScript实现启发的纯Python移植： https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking </中文翻译>