MCP Langbase Reasoning

🚀 mcp-langbase-reasoning

このモデルコンテキストプロトコル（MCP）サーバーは、Langbase Pipesによって提供される構造化された推論機能を備えています。Rustで書かれ、SQLiteを用いてデータを永続化します。

✨ 主な機能

• 12種類の推論モード - 線形、ツリー、発散、反射、バックトラッキング、自動選択、Graph-of-Thoughts、決定フレームワーク、証拠評価、タイムライン、MCTS、反事実的推論
• 推論タイムマシン - タイムラインベースの探索、MCTSによるガイド付き検索、反事実的な「もし...だったら」分析
• 5つのワークフロープリセット - コードレビュー、デバッグ、アーキテクチャ決定、戦略的決定、証拠に基づく結論
• 認知分析 - バイアス検出と論理的誤謬の特定
• 自律的自己改善 - 安全制御付きの4段階最適化ループ（監視 → 分析 → 実行 → 学習）
• セッションの永続化 - セッション、思考、ブランチ、チェックポイント、タイムラインをSQLiteに保存
• 本番環境対応 - 2000以上のテスト、非同期I/O、リトライロジック、構造化されたエラーハンドリング

🚀 クイックスタート

前提条件

• Rust 1.70以上
• APIキーを持つLangbaseアカウント

📦 インストール

git clone https://github.com/quanticsoul4772/mcp-langbase-reasoning.git
cd mcp-langbase-reasoning

# 環境設定
cp .env.example .env
# .envを編集: LANGBASE_API_KEY=your_key を設定

# ビルド
cargo build --release

MCPクライアントの設定

Claudeデスクトップの設定ファイル（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "langbase-reasoning": {
      "command": "/path/to/mcp-langbase-reasoning",
      "env": {
        "LANGBASE_API_KEY": "your_api_key"
      }
    }
  }
}

💻 使用例

利用可能なツール

コア推論

ツリーナビゲーション

チェックポイント

Graph-of-Thoughts

決定と証拠

タイムマシン

認知分析

ワークフロープリセット

組み込みプリセット: code-review, debug-analysis, architecture-decision, strategic-decision, evidence-based-conclusion

📚 ドキュメント

必要な設定

オプションの設定

🔧 技術詳細

自己改善システム

サーバーには、システムの健全性を監視し、問題を診断し、安全な最適化を実行し、結果から学習する自律的な自己改善ループが組み込まれています。システムの概要については、アーキテクチャの図を参照してください。

安全機能

• 常に有効 - 自己改善は継続的に実行されます
• サーキットブレーカー - 連続した失敗後に停止（デフォルト: 5回）
• アクション許可リスト - 事前に承認された安全なパラメータの変更のみ許可
• レート制限 - 1時間あたりの最大アクション数（デフォルト: 10回）
• 自動ロールバック - 退行を引き起こす変更を元に戻す
• クールダウン期間 - アクション間の最小時間（デフォルト: 60秒）
• AI検証 - 決定に対するバイアスと誤謬の検出

設定

許可されるアクション

システムは、事前定義された安全なパラメータのみを調整することができます。

CLIコマンド

# システムの状態を表示
cargo run -- self-improve status

# アクション履歴を表示
cargo run -- self-improve history

# システムを有効/無効にする
cargo run -- self-improve enable
cargo run -- self-improve disable

# 一時的に停止する
cargo run -- self-improve pause --duration 1h

# 現在の設定を表示
cargo run -- self-improve config

# 強制的に健全性チェックを実行
cargo run -- self-improve check

# 最後のアクションをロールバック
cargo run -- self-improve rollback

出力例

$ cargo run -- self-improve status

Self-Improvement System Status
==============================
Enabled:           true
Circuit State:     closed
Consecutive Fails: 0
In Cooldown:       false
Actions This Hour: 3/10
Total Cycles:      47
Total Successes:   42
Total Rollbacks:   2
Last Cycle:        2025-12-26T10:30:00Z

アーキテクチャ

┌─────────────┐     stdio      ┌──────────────────┐     HTTPS     ┌─────────────────┐
│ MCP Client  │◄──────────────►│ mcp-langbase-    │◄─────────────►│ Langbase Pipes  │
│ (Claude)    │   JSON-RPC     │   reasoning      │               │ (8 pipes)       │
└─────────────┘                └────────┬─────────┘               └─────────────────┘
                                        │                                  ▲
                                        │                                  │
                                        ▼                                  │
                               ┌──────────────────┐                        │
                               │     SQLite       │                        │
                               │  sessions,       │                        │
                               │  thoughts,       │                        │
                               │  graphs,         │                        │
                               │  metrics         │                        │
                               └────────┬─────────┘                        │
                                        │                                  │
                    ┌───────────────────┴───────────────────┐              │
                    │         Self-Improvement Loop         │              │
                    │  ┌─────────┐ ┌─────────┐ ┌─────────┐  │   diagnosis  │
                    │  │ Monitor │→│ Analyze │→│ Execute │──┼──────────────┘
                    │  └────┬────┘ └─────────┘ └────┬────┘  │
                    │       │      ┌─────────┐      │       │
                    │       └──────│  Learn  │◄─────┘       │
                    │              └─────────┘              │
                    └───────────────────────────────────────┘

開発

cargo build              # デバッグビルド
cargo build --release    # リリースビルド
cargo test               # 2000以上のテストを実行
cargo clippy -- -D warnings  # リント（警告なし）
cargo llvm-cov           # カバレッジレポートを生成

プロジェクト構造

src/
├── main.rs           # エントリポイント
├── config/           # 環境設定
├── error/            # 構造化されたエラータイプ
├── langbase/         # Langbase APIクライアント
├── modes/            # 12種類の推論実装
│   ├── timeline.rs   # タイムライン管理
│   ├── mcts.rs       # MCTS探索
│   └── counterfactual.rs  # 反事実的分析
├── presets/          # ワークフロープリセットシステム
├── self_improvement/ # 自律的最適化
├── server/           # MCPプロトコルの処理
└── storage/          # SQLiteの永続化

docs/
├── API_REFERENCE.md  # 完全なツールドキュメント
├── ARCHITECTURE.md   # 技術設計
├── LANGBASE_API.md   # パイプの統合
└── REASONING_TIME_MACHINE.md  # タイムマシンの設計

📄 ライセンス

MIT