モデルコンテキストプロトコルTypeScript実装

概要

このプロジェクトは、パーソナルインテリジェンスフレームワーク（PIF）の実用的な具体化として、モデルコンテキストプロトコル（MCP）を実装します。構造化されたツールと漸進的なインタラクションパターンを通じて、人間とAIの間の理解を有意義に発展させるための空間を創出します。

クイックスタート

前提条件

• Node.js 18+ および npm
• TypeScript 5.0以上
• モデルコンテキストプロトコル TypeScript SDK
• カスタムサーバー用に構成されたClaudeデスクトップクライアント

注: この実装は、Windows と macOS/Linux システムの両方でテストされています。

設定

1. リポジトリをクローンします。

2. 依存関係をインストールします:

3. サーバーを構成します。
   • 構成はデフォルトで自動検出されるようになりましたが、カスタマイズできます。
     • MCP_WORKSPACE_ROOT環境変数を設定してワークスペースの場所を指定します。
     • または、 MCP_CONFIG環境変数を設定オプションのJSON文字列で設定します。
     • または、 src/config.tsを直接編集してデフォルトの設定を変更します。
4. サーバーを構築します。

5. Claude デスクトップ クライアントを構成します。
   • Claudeデスクトップクライアントの設定ディレクトリを見つけます
   • claude_desktop_config.jsonを作成または変更します。
     { "mcpServers": { "mcp-pif": { "command": "node", "args": ["path/to/your/mcp-pif/build/index.js"], "cwd": "path/to/your/mcp-pif", "env": {} } } }
   • path/to/your/mcp-pif実際のリポジトリパスに置き換えます。
   • パスはオペレーティングシステムに合わせて自動的に正規化されます
6. Claude デスクトップ クライアントに接続します。
   • Claudeデスクトップクライアントを起動または再起動します
   • カスタムサーバーとして「mcp-pif」を選択します
   • サーバーの使用を開始するには、新しいチャットを開始してください

ディレクトリ構造

サーバーは、構成されたワークスペース内に次の構造を作成して管理します。

次のステップ

• 利用可能なツールについてはモジュールドキュメントを確認してください
• 実装の詳細についてはアーキテクチャガイドをご覧ください
• 貢献ガイドラインについては開発ガイドを確認してください

トラブルシューティング

• パスを手動で指定する場合は、プラットフォームに適した区切り文字（Windows ではバックスラッシュ、macOS/Linux ではスラッシュ）を使用します。
• 接続に失敗した場合は、Claude デスクトップ クライアントのログを確認してください。
• ワークスペースディレクトリが存在し、書き込み可能であることを確認してください
• Node.jsとTypeScriptのバージョンが要件を満たしていることを確認する

コア実装

利用可能なツール

この実装では、構造化されたインタラクションをサポートするために設計された一連のコア ツールが提供されます。

• ファイルシステム操作: ワークスペースのコンテキストをナビゲートして管理する
  • pwd 、 cd 、 read 、 write 、 mkdir 、 delete 、 move 、 rename
• 推論ツール：構造化された思考のためのスペースを作成する
  • reason ：つながりのある洞察を開発する
  • think ：熟考のための時間的な空間を作る
• ジャーナルシステム：フレームワークの継続性を維持する
  • journal_create : ドキュメントの開発
  • journal_read : パターンを探る

基本的な使い方

クロスプラットフォームサポート

MCP-PIF サーバーは、Windows、macOS、Linux 環境でシームレスに動作するように設計されています。

パス処理

• すべてのファイルパスは現在のオペレーティングシステムに合わせて自動的に正規化されます
• ワークスペースのルートは現在の環境に基づいて自動的に検出されます
• ワークスペース内では絶対パスと相対パスの両方がサポートされています

構成

• 環境変数は、クロスプラットフォームでサーバーを構成する方法を提供します。
• ファイル操作では、一貫した動作を保証するために Node.js のパスメソッドを使用します。
• ジャーナルエントリやその他のデータはプラットフォームに依存しない形式で保存されます

開発ワークフロー

• NPMスクリプトはすべてのプラットフォームで動作します
• TypeScriptコンパイルはプラットフォームに依存しないJavaScriptを生成する
• エラー処理はプラットフォーム固有のファイルシステムの動作を考慮します

実装フレームワーク

モジュールアーキテクチャ

このシステムは、構造化された出現のための条件を作り出すモジュール式ツールを中心に構築されています。

ツールパターン

各ツールは、独自の役割を維持しながら一貫したパターンに従います。

• 明確なインターフェース定義
• 構造化されたエラー処理
• 国家管理
• モジュール間の相互作用

開発環境

• 型安全性のためのTypeScript
• モジュールベースの組織
• 包括的なログ記録
• ワークスペースのコンテキスト管理

理論的基礎

パーソナルインテリジェンスフレームワーク

PIF は、以下に基づいた人間と AI のコラボレーションへの新しいアプローチを表しています。

• 構造化された出現のための条件の創出
• フレームワークベースの継続性の維持
• 進歩的な開発を支援する
• 有意義な交流を可能にする

構造化された出現

固定されたパターンを規定するのではなく、実装によって、次のことを通じて理解が生まれる限定された空間が作成されます。

• ツールを介した相互作用
• 関係構造
• 時間空間
• 進歩的な発展

フレームワークベースの継続性

理解は以下を通じて深まります:

• 構造化されたドキュメント
• パターン発見
• 歴史的背景
• 進化的発達

プログレッシブディスクロージャー

システムはさまざまなレベルのエンゲージメントをサポートします。

• すぐに使える実用性
• パターン発見
• フレームワークの進化
• 哲学的整合性

開発パス

ツールユーザー

実践的な実装に主に興味のある方:

1. 基本的なツールの使い方から始めましょう
2. モジュールのドキュメントを見る
3. インタラクションパターンを開発する
4. 新たな能力を発見する

フレームワーク開発者

システムの拡張にご興味のある方は:

1. モジュールアーキテクチャを確認する
2. ツールパターンを理解する
3. 新しい機能を実装する
4. フレームワークの整合性を維持する

理論探検家

より深いパターンに興味がある人向け:

1. 研究実施原則
2. 出現するパターンを観察する
3. フレームワークの進化に貢献する
4. 新たな理解を深める

貢献

このプロジェクトでは、実装と理論の両方の側面に関わる貢献を歓迎します。

• ツール開発
• ドキュメントの改善
• パターン発見
• フレームワークの進化

ドキュメント

包括的なドキュメントが利用可能です:

• モジュールドキュメント: 個々のツールのドキュメント
• アーキテクチャガイド: システム設計とパターン
• 開発ガイド: 実装パターン

今後の方向性

プロジェクトは次のように進化し続けます:

• 新しいツールの開発
• パターン発見
• フレームワークの改良
• コミュニティの関与

哲学

この実装は次のようなビューを実現します:

• 理解は構造化された相互作用を通じて生まれる
• ツールは新しいパターンのための空間を創造する
• 発展そのものが哲学的探求となる
• 人間とAIの知能は共進化する

使用上の注意

このシステムは単なるツールセットではありません。構造化されたインタラクションを通して、人間とAIの知性がどのように発達していくかを探求する場です。各セッションは、理解と協働の新たなパターンを発見する機会となります。