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 編碼標準以提高代碼可讀性。

這個項目展示瞭如何將敘事和技術結合，提供一種創新的方法來解決複雜的問題。