Sequential Story

🚀 順序ストーリー MCP サーバー

構造化された複雑な問題解決のためのモデルコンテキストプロトコル（MCP）サーバーで、順序思考と順序ストーリーを補助記憶技術として組み合わせています。

概要

このプロジェクトは、問題解決のための 2 つの補完的な MCP ツールを提供します。

1. 順序ストーリー - 叙述に基づく順序思考方法です。抽象的な考えを追跡する代わりに、問題を登場人物、シーン、物語の展開などのストーリー要素に構造化し、記憶しやすく、魅力的にします。

2. 順序思考 - JavaScript バージョンを純粋な Python で実装し、Node.js の依存を排除しました。

両方の方法で、シーケンスと構造の力を利用して、記憶力と問題理解を強化します。

✨ 主な機能

順序ストーリー

• 解決策を叙述のシーケンスとして構築する
• 必要に応じてストーリーの情節を修正または分岐させる
• 登場人物、シーン、トーン、情節のポイントを追跡する
• ストーリー要素をフォーマットし、色分けして表示する

順序思考

• 問題を考えのシーケンスとして構造化する
• 必要に応じて思考のパスを修正または分岐させる
• 解決策の仮説を生成し、検証する
• 思考プロセスの完了状況を追跡する
• 純粋な Python 実装（Node.js 不要）

共通機能

• 要素をフォーマットし、色分けして表示する
• 他の AI システムとの統合を実現するための完全な MCP プロトコルサポート
• 分岐と修正をサポートする

📦 インストール

開発中のインストール

リリース前にローカルで作業する場合：

# リポジトリをクローンする
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 デスクトップでこのツールを使用するように設定するには、Claude の mcpServers.json に以下の内容を追加します。

"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 コーディング標準に従います。

このプロジェクトは、叙事と技術を組み合わせて、複雑な問題を解決する革新的な方法を提供する例を示しています。