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

概要

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

Related MCP server: CodeAlive MCP

クイックスタート

前提条件

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

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

設定

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

git clone [https://github.com/hungryrobot1/MCP-PIF]
cd mcp-pif

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

npm install

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

npm run build

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の知性がどのように発達していくかを探求する場です。各セッションは、理解と協働の新たなパターンを発見する機会となります。

MCP-PIF Server