Personal Context Technology MCP Server

Personal Context Technology MCP サーバー

このリポジトリは、Model Context Protocol（MCP）を使用してPersonal Context Technology（PCT）用のサーバーを実装しています。Claude などの AI アシスタントが、パーソナライズされたコンテキストデータにアクセスして更新できるようにし、セッション間で永続的な記憶を作成します。

Personal Context Technology とは？

Personal Context Technology を使用すると、AI アシスタントがよりパーソナライズされた適切な回答を提供するために利用できる個人データを構造化し、管理できます。PCT を使うと、次のことが可能です。

• AI セッション間でコンテキストが保持されます
• データを保存する場所（ローカル、クラウドなど）を管理できます
• AI システムがデータをどのように使用するか、明示的な指示を定義できます
• 好みや状況の変化に応じて、コンテキストを更新できます

機能

• 永続的なコンテキストストレージ：好み、目標、学習スタイル、その他の個人情報を保存します
• プライバシー管理：指示ブロックで、情報を非公開にするか公開するかを定義します
• セクション単位のアクセス：コンテキスト全体または個別のセクションにアクセスします
• コンテキストの更新：updateContext ツールを使用して特定のフィールドを更新します
• バージョン管理：コンテキストの変更履歴を保持します

デモ

Personal Context Technology MCP Server の動作をご覧ください。

このデモでは、次の方法を紹介します。

• MCP ツールを使用して個人のコンテキストデータにアクセスする
• updateContext ツールを使用してコンテキスト情報を更新する
• パーソナライズされたコンテキストによって Claude の回答がどのように改善されるかを確認する

インストール

前提条件

• Node.js（v16+）
• npm（Node.js に含まれています）

セットアップ手順

1. リポジトリをクローンする

git clone https://github.com/mikhashev/pct-mcp-server.git
cd pct-mcp-server

2. 依存関係をインストールする

npm install

3. サーバーをビルドする

npm run build

4. サーバーを起動する

npm start

Claude Desktop への接続

このサーバーを Claude Desktop で使用するには：

Windows

1. Claude Desktop を開きます
2. Settings > Developer > Edit Config に移動します
3. %AppData%\Claude Desktop\ ディレクトリが開きます
4. 次の内容で claude_desktop_config.json を作成または編集します。

{
  "mcpServers": {
    "personal-context-server": {
      "command": "node",
      "args": ["PATH_TO_YOUR_PROJECT/pct-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

PATH_TO_YOUR_PROJECT をプロジェクトの実際のパスに置き換えてください。

macOS

1. Claude Desktop を開きます
2. Settings > Developer > Edit Config に移動します
3. ~/Library/Application Support/Claude Desktop/ ディレクトリが開きます
4. 次の内容で claude_desktop_config.json を作成または編集します。

{
  "mcpServers": {
    "personal-context-server": {
      "command": "node",
      "args": ["/path/to/your/project/pct-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Linux

1. Claude Desktop を開きます
2. Settings > Developer > Edit Config に移動します
3. ~/.config/Claude Desktop/ ディレクトリが開きます
4. 次の内容で claude_desktop_config.json を作成または編集します。

{
  "mcpServers": {
    "personal-context-server": {
      "command": "node",
      "args": ["/path/to/your/project/pct-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Personal Context Server の使用方法

Claude Desktop での使用

1. npm start を使用して PCT MCP サーバーを起動します
2. 必要に応じて Claude Desktop を再起動します
3. Claude の入力欄にある MCP ツールアイコン（レンチ／ツールアイコン）をクリックします
4. 利用可能なツールとリソースとともに「personal-context-server」が表示されます。
   • リソース：コンテキストデータ全体またはセクションごとのデータにアクセスします
   • ツール：コンテキスト内の特定のフィールドを更新します

コンテキストデータへのアクセス

Claude は、次の 2 つの方法で個人のコンテキストデータにアクセスできます。

1. コンテキスト全体：「All Sections」を選択すると、個人のコンテキスト全体へのアクセスを Claude に許可します
2. セクション単位：特定のセクション（basic_info、preferences など）を選択すると、コンテキストの一部だけを共有できます

プロンプトの例：「私のコンテキストデータを使って、私の学習スタイルに合った学習リソースをいくつかおすすめしてください。」

コンテキストデータの更新

updateContext ツールを使用して、個人のコンテキストを更新できます。

プロンプトの例：「実践的な例があると学びやすいとわかったので、preferences の learning_style を『visual and hands-on』に更新してください。」

コンテキストのカスタマイズ

デフォルトの個人コンテキストには、次の項目が含まれます。

• basic_info：名前、所在地など
• preferences：コミュニケーションスタイル、学習の好みなど
• instruction：AI がコンテキストを使用・更新する方法に関するルール
• metadata：バージョン管理、更新履歴

src/storage/contextStorage.ts の DEFAULT_CONTEXT オブジェクトを編集すると、デフォルトの構造を変更できます。 または、リポジトリ内のテンプレートデータ（https://github.com/mikhashev/personal-context-manager/blob/main/use-cases/self-education/personal_context_self_education_template.json）や別のテンプレートから、更新ファイル [PATH_TO_YOUR_PROJECT/pct-mcp-server/data/personal_context.json] を置き換えてください。

プロジェクト構成

pct-mcp-server/
├── .git/                      # Git repository data
├── .gitignore                 # Git ignore rules
├── LICENSE                    # License file
├── README.md                  # Project documentation
├── package-lock.json          # Lock file for npm dependencies 
├── package.json               # Project configuration and dependencies
├── tsconfig.json              # TypeScript configuration
└── src/                       # Source code
    ├── index.ts               # Main application entry point
    ├── resources/             # MCP resources implementation
    │   └── personalContext.ts # Personal context resource
    ├── storage/               # Storage implementation
    │   └── contextStorage.ts  # Context storage functionality
    ├── tools/                 # MCP tools implementation
    │   ├── contextSuggestion.ts  # Context suggestion tool
    │   └── updateContext.ts   # Update context tool
    └── utils/                 # Utility functions
        └── instructionHandler.ts  # Instruction handling logic

# Generated directories (not in repository)
# ----------------------------------------
# dist/                        # Compiled JavaScript files (gitignored)
# node_modules/                # Dependencies (gitignored)
# data/                        # User data (gitignored or contains only samples)
#   └── personal_context.json  # Personal context data (sample only) (don't change filename personal_context.json, update data if need)

詳細設定

HTTP トランスポートの使用

デフォルトの実装では、開発用に stdio トランスポートを使用します。本番環境では、HTTP トランスポートに切り替えることができます。

1. src/index.ts を編集します
2. HTTP トランスポートのセクションのコメントを解除します
3. 使用するポートと CORS の設定を行います
4. サーバーを再ビルドして再起動します

! ローカルマシンで開発する場合は、常に stdio トランスポートを使うことをおすすめします。

マルチユーザー対応

複数のユーザーに対応するには、contextStorage.js ファイルを変更し、ユーザー ID に基づいてユーザーごとのファイルにコンテキストを保存します。

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。プロジェクトに適用されるライセンスについては、LICENSE をご覧ください。

謝辞

このプロジェクトは Personal Context Technology のコンセプトに基づいており、AI システムが外部コンテキストにアクセスできるようにするため、Anthropic が開発した Model Context Protocol（MCP）を実装しています。