🚀 顺序故事 MCP 服务器
本项目是一个用于结构化复杂问题解决的模型上下文协议（MCP）服务器，它巧妙结合了序贯思维和顺序故事这两种助记术技术，为解决复杂问题提供了创新且高效的途径。
🚀 快速开始
此项目提供了两种互补的 MCP 工具来解决问题：
- 顺序故事：这是一种基于叙述的序贯思维方法。它不跟踪抽象思想，而是将问题结构化为故事情节中的元素，涵盖角色、场景和情节发展，让问题更易记忆且更具吸引力。
- 顺序思维：这是纯 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": "中等自信"
}
高级用法
- 安装依赖项：确保你已经安装了 Python 和 pip。然后运行
pip install -r requirements.txt。 - 配置环境变量（可选）：根据需要设置
TOOLS环境变量以启用特定功能。 - 运行工具：
- 对于顺序故事，使用
python src/story_generator.py - 对于顺序思维，使用
python src/thinker.py
- 对于顺序故事，使用
- 输入交互：按照提示输入你的查询或问题。
📚 详细文档
注意事项
- 保持代码库清洁和可维护。
- 定期测试功能以确保正常工作。
- 遵循 PEP8 编码标准以提高代码可读性。
这个项目展示了如何将叙事和技术结合，提供一种创新的方法来解决复杂的问题。