opentokenz/mcpx

何を解決するか

MCPX は、開発者のローカル環境（ワークスペース、ソースコード、ターミナルコマンド、システム機能など）を、ChatGPT、Claude、Cursor、Grok などの AI クライアントに安全に公開するためのローカル MCP（Model Context Protocol）ランタイムおよびゲートウェイです。AI モデルがセキュリティを損なうことなく、信頼性があり、監査可能で状態保持可能な方法でローカル開発資産とやり取りできるようにします。セッション間でコンテキストを失う問題も解消します。

動作方法

MCPX は AI クライアントとローカルマシンの間のミドルウェアとして機能します。Streamable HTTP を使ってクライアントと通信し、SQLite データベースで状態を管理します。主なメカニズムは以下の通りです：

• リモートセッション：remote_session_id を使ってワークスペースの状態、権限、履歴を永続化し、モデルが異なる接続やクライアント間で作業を再開できるようにします。
• ワークスペース管理：ユーザーは特定のプロジェクトディレクトリをワークスペースとして登録し、ランタイムがそれらをセッションにバインドします。
• ツールオーケストレーション：ファイルの読み取り（SHA-256 検証付き）、ファイルの編集（恒等的置換を使用）、ターミナルコマンドの実行（セキュリティポリシーエンジン付き）、プロジェクトタスクの管理といった一連のコアツールを提供します。
• セキュリティレイヤー：コマンド（許可／確認／拒否）およびファイルに対して厳格なセキュリティポリシーを実装し、リモートアクセスには OAuth、Bearer トークン、ACL をサポートします。
• 拡張システム：ローカルの「スキル」と上流の MCP サーバーを検出・統合でき、モデルがこれらのツールを呼び出すための統一インターフェースを提供します。

対象ユーザー

• ローカルコードベースやターミナルに深く安全にアクセスさせたい AI アシスタント開発者
• AI エージェントがソースコードを変更した履歴やコマンド実行の記録を監査したいチーム
• MCP 対応クライアント（ChatGPT、Claude など）のパワーユーザーで、永続的でプロフェッショナルなローカルランタイムを求める人

特徴

• 状態保持の継続性：永続的な ID を使って、異なる AI クライアント間でセッションを再開可能。
• 高精度な編集：SHA ベースのリビジョンガードと正確な置換により、ファイルの破損を回避。
• 安全な削除：2段階の move_out プロセス（準備 → 確認 → 提出）で、ファイルをシステムのゴミ箱に移動し、永続削除を防ぎます。
• セキュリティ最優先の実行：リスクの高い操作（例：git push、docker）に対してユーザーの確認を要求する細かいコマンドポリシーエンジン。
• 拡張性のあるアーキテクチャ：他の MCP サーバーとカスタムローカルスキルとシームレスに統合可能。
• 環境認識能力：OS、アーキテクチャ、ツールチェーンに関する詳細なメタデータをモデルに提供。