顺序故事 MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于将顺序思考和顺序故事作为解决问题的记忆技巧。

概述

本项目提供两种互补的 MCP 工具，用于构建复杂问题：

1. 顺序故事 - 一种基于叙事的顺序思考方法。它不是跟踪抽象的想法，而是将问题构建为具有角色、场景和情节发展的故事情节，使其更易于记忆和引人入胜。

2. 顺序思考 - JavaScript 实现的纯 Python 端口，消除了 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 "Sequential Story"

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

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

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

对于开发：

# 用于使用 MCP Inspector 进行开发
mcp dev src/__main__.py:main

您还可以通过将以下内容添加到您的 Claude mcpServers.json 中，来配置 Claude 桌面以使用 uvx 工具：

"mcpServers": {
  "Sequential Story": {
    "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 hooks
uv run pre-commit install

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

鸣谢

本项目建立在顺序思考和结构化问题解决的概念之上，将这些方法调整为分析和叙事框架，以增强记忆力和问题解决能力。

顺序思考的实现是纯 Python 端口，其灵感来自模型上下文协议存储库中的 JavaScript 实现： https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking