モデルコンテキストプロトコルTypeScript実装
概要
このプロジェクトは、パーソナルインテリジェンスフレームワーク（PIF）の実用的な具体化として、モデルコンテキストプロトコル（MCP）を実装します。構造化されたツールと漸進的なインタラクションパターンを通じて、人間とAIの間の理解を有意義に発展させるための空間を創出します。
クイックスタート
前提条件
- Node.js 18+ および npm
- TypeScript 5.0以上
- モデルコンテキストプロトコル TypeScript SDK
- カスタムサーバー用に構成されたClaudeデスクトップクライアント
注: この実装は、Windows と macOS/Linux システムの両方でテストされています。
設定
- リポジトリをクローンします。
git clone [https://github.com/hungryrobot1/MCP-PIF]
cd mcp-pif
- 依存関係をインストールします:
- サーバーを構成します。
- 構成はデフォルトで自動検出されるようになりましたが、カスタマイズできます。
MCP_WORKSPACE_ROOT環境変数を設定してワークスペースの場所を指定します。- または、
MCP_CONFIG環境変数を設定オプションのJSON文字列で設定します。 - または、
src/config.tsを直接編集してデフォルトの設定を変更します。
- サーバーを構築します。
- 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実際のリポジトリパスに置き換えます。- パスはオペレーティングシステムに合わせて自動的に正規化されます
- Claude デスクトップ クライアントに接続します。
- Claudeデスクトップクライアントを起動または再起動します
- カスタムサーバーとして「mcp-pif」を選択します
- サーバーの使用を開始するには、新しいチャットを開始してください
ディレクトリ構造
サーバーは、構成されたワークスペース内に次の構造を作成して管理します。
workspace/
├── home/
│ ├── meta/
│ │ └── journal/ # For storing journal entries
│ └── projects/ # For user projects
次のステップ
トラブルシューティング
- パスを手動で指定する場合は、プラットフォームに適した区切り文字（Windows ではバックスラッシュ、macOS/Linux ではスラッシュ）を使用します。
- 接続に失敗した場合は、Claude デスクトップ クライアントのログを確認してください。
- ワークスペースディレクトリが存在し、書き込み可能であることを確認してください
- Node.jsとTypeScriptのバージョンが要件を満たしていることを確認する
コア実装
利用可能なツール
この実装では、構造化されたインタラクションをサポートするために設計された一連のコア ツールが提供されます。
- ファイルシステム操作: ワークスペースのコンテキストをナビゲートして管理する
pwd 、 cd 、 read 、 write 、 mkdir 、 delete 、 move 、 rename
- 推論ツール：構造化された思考のためのスペースを作成する
reason ：つながりのある洞察を開発するthink ：熟考のための時間的な空間を作る
- ジャーナルシステム：フレームワークの継続性を維持する
journal_create : ドキュメントの開発journal_read : パターンを探る
基本的な使い方
// Create a structured thought pattern
reason: {
thoughts: [
{ content: "Initial observation" },
{
content: "Building on previous thought",
relationType: "sequence",
relationTo: 0
}
]
}
// Document development
journal_create: {
title: "Implementation Pattern",
content: "Insights about development...",
tags: ["development", "patterns"]
}
クロスプラットフォームサポート
MCP-PIF サーバーは、Windows、macOS、Linux 環境でシームレスに動作するように設計されています。
パス処理
- すべてのファイルパスは現在のオペレーティングシステムに合わせて自動的に正規化されます
- ワークスペースのルートは現在の環境に基づいて自動的に検出されます
- ワークスペース内では絶対パスと相対パスの両方がサポートされています
構成
- 環境変数は、クロスプラットフォームでサーバーを構成する方法を提供します。
- ファイル操作では、一貫した動作を保証するために Node.js のパスメソッドを使用します。
- ジャーナルエントリやその他のデータはプラットフォームに依存しない形式で保存されます
開発ワークフロー
- NPMスクリプトはすべてのプラットフォームで動作します
- TypeScriptコンパイルはプラットフォームに依存しないJavaScriptを生成する
- エラー処理はプラットフォーム固有のファイルシステムの動作を考慮します
実装フレームワーク
モジュールアーキテクチャ
このシステムは、構造化された出現のための条件を作り出すモジュール式ツールを中心に構築されています。
src/
├── core/ # Framework foundations
├── mcp_modules/ # Tool implementations
└── api/ # External integrations
ツールパターン
各ツールは、独自の役割を維持しながら一貫したパターンに従います。
- 明確なインターフェース定義
- 構造化されたエラー処理
- 国家管理
- モジュール間の相互作用
開発環境
- 型安全性のためのTypeScript
- モジュールベースの組織
- 包括的なログ記録
- ワークスペースのコンテキスト管理
理論的基礎
パーソナルインテリジェンスフレームワーク
PIF は、以下に基づいた人間と AI のコラボレーションへの新しいアプローチを表しています。
- 構造化された出現のための条件の創出
- フレームワークベースの継続性の維持
- 進歩的な開発を支援する
- 有意義な交流を可能にする
構造化された出現
固定されたパターンを規定するのではなく、実装によって、次のことを通じて理解が生まれる限定された空間が作成されます。
- ツールを介した相互作用
- 関係構造
- 時間空間
- 進歩的な発展
フレームワークベースの継続性
理解は以下を通じて深まります:
- 構造化されたドキュメント
- パターン発見
- 歴史的背景
- 進化的発達
プログレッシブディスクロージャー
システムはさまざまなレベルのエンゲージメントをサポートします。
- すぐに使える実用性
- パターン発見
- フレームワークの進化
- 哲学的整合性
開発パス
ツールユーザー
実践的な実装に主に興味のある方:
- 基本的なツールの使い方から始めましょう
- モジュールのドキュメントを見る
- インタラクションパターンを開発する
- 新たな能力を発見する
フレームワーク開発者
システムの拡張にご興味のある方は:
- モジュールアーキテクチャを確認する
- ツールパターンを理解する
- 新しい機能を実装する
- フレームワークの整合性を維持する
理論探検家
より深いパターンに興味がある人向け:
- 研究実施原則
- 出現するパターンを観察する
- フレームワークの進化に貢献する
- 新たな理解を深める
貢献
このプロジェクトでは、実装と理論の両方の側面に関わる貢献を歓迎します。
- ツール開発
- ドキュメントの改善
- パターン発見
- フレームワークの進化
ドキュメント
包括的なドキュメントが利用可能です:
今後の方向性
プロジェクトは次のように進化し続けます:
- 新しいツールの開発
- パターン発見
- フレームワークの改良
- コミュニティの関与
哲学
この実装は次のようなビューを実現します:
- 理解は構造化された相互作用を通じて生まれる
- ツールは新しいパターンのための空間を創造する
- 発展そのものが哲学的探求となる
- 人間とAIの知能は共進化する
使用上の注意
このシステムは単なるツールセットではありません。構造化されたインタラクションを通して、人間とAIの知性がどのように発達していくかを探求する場です。各セッションは、理解と協働の新たなパターンを発見する機会となります。