Pct MCP Server

🚀 個人コンテキスト技術 MCP サーバー

このリポジトリは、Personal Context Technology (PCT) に基づくモデルコンテキストプロトコル（MCP）サーバーを実装しています。これにより、AI アシスタントはユーザーの個人情報にアクセスし、更新することができ、会話間で永続的な記憶を保持することが可能です。

🚀 クイックスタート

このサーバーを使用することで、AI アシスタントはユーザーの個人情報にアクセスし、更新することができ、会話間で永続的な記憶を保持することができます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 永続的なストレージ：ユーザーデータの永続的な保存をサポートします。
• プライバシーコントロール：ルールと制限により、ユーザーのプライバシーを保護します。
• セクションベースのアクセス：コンテキストをセクション（セクション）ごとに細かく制御できます。
• 更新履歴：コンテキストの変更履歴とバージョン情報を記録します。

📦 インストール

プロジェクトのクローン

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

依存関係のインストール

npm install

コンテキストストレージパスの設定

• src/storage/contextStorage.ts ファイルを編集します。
• DEFAULT_CONTEXT オブジェクトを必要に応じて変更します。

サーバーの起動

npm start

💻 使用例

基本的な使用法

1. コンテキストファイルの初期化：

cp data/personal_context.json.example data/personal_context.json

2. personal_context.json ファイルを編集し、個人情報を追加または更新します。

3. サーバーを起動し、API エンドポイントにアクセスして機能をテストします。

高度な使用法

コンテキストの取得

curl http://localhost:3000/api/context

コンテキストの更新

curl -X PUT http://localhost:3000/api/context/basic_info/name \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe"}'

📚 ドキュメント

個人コンテキスト技術

個人コンテキスト技術（PCT）は、ユーザーの個人情報を管理するための技術で、モデルコンテキストプロトコル（MCP）を介して AI システムとのやり取りを実現します。この技術は、AI アシスタントの機能を強化し、ユーザーのコンテキスト情報に基づいて、よりスマートで個別化されたサービスを提供することを目的としています。

カスタムコンテキスト

デフォルトの個人コンテキストには、以下の部分が含まれています。

• basic_info：名前、位置などの基本情報。
• preferences：コミュニケーションスタイル、学習の好みなど。
• instruction：AI がコンテキストを使用および更新するためのルール。
• metadata：バージョントラッキングと更新履歴。

src/storage/contextStorage.ts ファイルを編集するか、データディレクトリ内の personal_context.json ファイルを置き換えることで、コンテキスト構造をカスタマイズできます。

プロジェクト構造

pct-mcp-server/
├── .git/                      # Git リポジトリデータ
├── .gitignore                 # Git 無視ルール
├── LICENSE                    # ライセンスファイル
├── README.md                  # プロジェクトドキュメント
├── package-lock.json          # npm ロックファイル
├── package.json               # プロジェクト設定と依存関係
├── tsconfig.json              # TypeScript 設定
└── src/                       # ソースコード
    ├── index.ts               # アプリケーションエントリポイント
    ├── resources/             # MCP リソース実装
    │   └── personalContext.ts # 個人コンテキストリソース
    ├── storage/               # ストレージ実装
    │   └── contextStorage.ts  # コンテキストストレージ機能
    ├── tools/                 # MCP ツール実装
    │   ├── contextSuggestion.ts  # コンテキスト提案ツール
    │   └── updateContext.ts   # コンテキスト更新ツール
    └── utils/                 # ユーティリティ関数
        └── instructionHandler.ts  # 命令処理ロジック

# 自動生成されるディレクトリ（リポジトリには含まれません）
# ----------------------------------------
# dist/                        # コンパイルされた JavaScript ファイル（無視されます）
# node_modules/                # 依存関係（無視されます）
# data/                        # ユーザーデータ（無視またはサンプルファイルのみ）
#   └── personal_context.json  # 個人コンテキストデータ（サンプルファイル、ファイル名は変更しないでください personal_context.json、データを更新する場合は内容を変更してください）

高度な設定

HTTP トランスポートの使用

デフォルトの実装では、開発用に stdio トランスポートを使用しています。本番環境で HTTP トランスポートを使用するには、以下の手順を実行します。

1. src/index.ts ファイルを編集します。
2. HTTP トランスポートの部分のコメントを解除します。
3. 必要なポートと CORS 設定を構成します。
4. サーバーを再起動します。

機能拡張

• マルチユーザーコンテキスト管理のサポート
• コンテキストの同期とバックアップ機能の実装

貢献ガイド

コードの貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをフォークし、ブランチを作成します。

git checkout -b feature/your-feature-name

2. 変更をコミットします。

git add .
git commit -m "機能追加：your-feature-name"

3. リポジトリにプッシュし、プルリクエストを送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。