Mirror MCP

🚀 mirror-mcp

mirror-mcpは、reflectツールを提供するModel Context Protocol (MCP)サーバーです。これにより、LLMは再帰的な質問とMCPサンプリングを通じて、自己反省と内省を行うことができます。

🚀 クイックスタート

mirror-mcpを使用すると、AIモデルは反射メカニズムを通じて「自分自身を見る」ことができます。LLMがreflectツールを使用すると、自分自身に質問を投げかけ、Model Context Protocolのサンプリング機能を通じて回答を受け取ることができます。これにより、自己分析、推論の検証、反復的な問題解決のための強力なフィードバックループが作成されます。

✨ 主な機能

• 🪞 自己反射ツール：LLMが自分自身に質問を投げかけ、計算された応答を受け取ることを可能にします。
• 🔄 MCPサンプリング統合：応答にModel Context Protocolのサンプリングメカニズムを使用します。
• 📦 npmでインストール可能：簡単なインストールとデプロイが可能です。
• ⚡ 軽量：依存関係が少なく、起動が速いです。
• 🔧 設定可能：反射パラメータとサンプリングオプションをカスタマイズできます。

📦 インストール

VS Codeのクイックインストール

MCPホスト設定

他のMCP互換クライアントの場合は、以下の設定を追加してください。

{
  "type": "stdio",
  "command": "npx", 
  "args": ["mirror-mcp@latest"]
}

npm経由

npm install -g mirror-mcp

npx経由（インストール不要）

npx mirror-mcp

ソースから

git clone https://github.com/toby/mirror-mcp.git
cd mirror-mcp
npm install
npm run build
npm start

📚 ドキュメント

ツール

reflect

このツールは、LLMが自分自身に質問を投げかけ、MCPサンプリングを通じて応答を受け取ることを可能にします。カスタムのシステムプロンプトとユーザープロンプトをサポートしており、LLMがどのような応答を得るかを自己指示することができます。

カスタムプロンプトによる自己指示：

• システムプロンプト：反射の役割や視点を定義します（例：「専門のコーチ」、「批判的な思考者」、「創造的な問題解決者」）
• ユーザープロンプト：反射応答の形式、構造、または焦点を指定します
• デフォルトの動作：カスタムプロンプトが提供されない場合、強み、弱み、仮定、および代替視点に焦点を当てた組み込みの反射ガイダンスを使用します

パラメータ：

• question (文字列、必須)：LLMが自分自身に投げかけたい質問
• context (文字列、オプション)：反射のための追加のコンテキスト
• system_prompt (文字列、オプション)：反射アプローチを指示するためのカスタムシステムプロンプト
• user_prompt (文字列、オプション)：デフォルトの反射指示を置き換えるためのカスタムユーザープロンプト
• max_tokens (数値、オプション)：応答の最大トークン数（デフォルト：500）
• temperature (数値、オプション)：サンプリング温度（デフォルト：0.8）

例：

{
  "name": "reflect",
  "arguments": {
    "question": "How confident am I in my previous analysis of the data?",
    "context": "Previous analysis showed a 23% increase in user engagement",
    "max_tokens": 300,
    "temperature": 0.6
  }
}

カスタムプロンプトを使用した例：

{
  "name": "reflect",
  "arguments": {
    "question": "What are the potential weaknesses in my reasoning?",
    "system_prompt": "You are an expert critical thinking coach helping to identify logical fallacies and reasoning gaps.",
    "user_prompt": "Analyze my reasoning step-by-step and provide specific examples of potential weaknesses or blind spots.",
    "context": "Working on a complex machine learning model evaluation",
    "max_tokens": 400,
    "temperature": 0.7
  }
}

応答：

{
  "reflection": "Upon reflection, my confidence in the 23% engagement increase analysis is moderate to high. The data sources appear reliable, and the methodology follows standard practices. However, I should consider potential confounding variables such as seasonal effects or concurrent marketing campaigns that might influence the results.",
  "metadata": {
    "tokens_used": 67,
    "reflection_time_ms": 1240
  }
}

🔧 技術詳細

設計哲学

mirror-mcpは、自己反射が堅牢なAI推論に不可欠であるという原則に基づいて構築されています。モデルが自分自身の出力と推論プロセスに質問を投げかけることを可能にすることで、以下の機会を生み出します。

• エラー検出：モデルが自分の論理に潜在的な欠陥を特定できます。
• 信頼度の較正：自己評価により確信度を測定するのに役立ちます。
• 反復的な改善：反射的な質問により、より良い解決策が得られる可能性があります。
• メタ認知的な認識：モデル自身の推論プロセスの理解。

技術アーキテクチャ

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   LLM Client    │───▶│   mirror-mcp    │───▶│  MCP Sampling   │
│                 │    │                 │    │   Infrastructure │
│ Calls reflect() │    │ Processes       │    │                 │
│                 │◀───│ reflection      │◀───│ Returns response│
└─────────────────┘    └─────────────────┘    └─────────────────┘

主要コンポーネント

1. 反射エンジン：入力された自己指示の質問を処理します。
2. サンプリングインターフェース：MCPのサンプリング機能とインターフェースを取ります。
3. コンテキストマネージャー：一貫した反射のために会話コンテキストを維持します。
4. 応答フォーマッター：最適な消費のために反射応答を構造化します。

なぜMCPを使用するのか？

Model Context Protocolは、AIモデルが外部リソースやツールに接続するための標準化された方法を提供します。mirror-mcpをMCPサーバーとして実装することで、以下のことが保証されます。

• 相互運用性：MCP互換のクライアントと互換性があります。
• 標準化：ツール統合のための確立されたプロトコルに従います。
• 拡張性：他のMCPサーバーと一緒にデプロイできます。
• 将来性：MCPエコシステムの継続的な開発の恩恵を受けることができます。

サンプリング戦略

反射メカニズムは、MCPのサンプリング機能を利用して、深思熟慮された応答を生成します。サンプリングプロセスは以下の通りです。

1. 自己指示の質問をプロンプトとして受け取ります。
2. 構成可能なサンプリングパラメータ（温度、最大トークン数）を適用します。
3. 基盤となるモデルを使用して応答を生成します。
4. 適切なメタデータとともに反射を返します。 このアプローチにより、反射は元の推論と同じモデル機能を使用して生成され、本物の自己評価が行われます。

開発

前提条件

• Node.js 18以上
• npmまたはyarn
• TypeScript（開発用）

開発環境のセットアップ

git clone https://github.com/toby/mirror-mcp.git
cd mirror-mcp
npm install
npm run dev

テスト

npm test

ビルド

npm run build

コントリビュート

コントリビューションを歓迎します！詳細については、コントリビューションガイドラインを参照してください。

コントリビューションの分野

• 強化された反射戦略
• 追加のサンプリングパラメータ
• パフォーマンスの最適化
• ドキュメントの改善
• テストカバレッジの拡張

関連プロジェクト

• Model Context Protocol：基礎となるプロトコル仕様
• MCPエコシステム：他の様々なMCPサーバーとツール

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

謝辞

• 基礎となる仕様を作成したModel Context Protocolチーム
• メタ認知と自己反射に取り組む幅広いAI研究コミュニティ
• このツールを形作るのに役立ったコントリビューターと初期のユーザー

"省みぬ人生は生きる価値がない" - ソクラテス

mirror-mcpを使って、あなたのAIモデルに自分自身の推論を検証させましょう。