Pct MCP Server

🚀 個人上下文技術 MCP 服務器

本項目實現了一個基於 Personal Context Technology (PCT) 的模型上下文協議（MCP）服務器。藉助該服務器，AI 助手能夠訪問和更新用戶的個性化數據，進而在會話之間維持持久記憶，為用戶提供更貼合需求的服務。

🚀 快速開始

安裝與配置

1. 克隆項目倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 配置上下文存儲路徑：

   • 編輯 src/storage/contextStorage.ts 文件。
   • 修改 DEFAULT_CONTEXT 對象以適應您的需求。

4. 啟動服務器：

   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"}'
  

✨ 主要特性

• 持久存儲：支持用戶數據的持久化存儲。
• 隱私控制：通過規則和限制保護用戶隱私。
• 基於節目的訪問：允許按節目（section）對上下文進行細粒度控制。
• 更新歷史：記錄上下文的修改歷史和版本信息。

📦 安裝指南

1. 克隆項目倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 配置上下文存儲路徑：

   • 編輯 src/storage/contextStorage.ts 文件。
   • 修改 DEFAULT_CONTEXT 對象以適應您的需求。

4. 啟動服務器：

   npm start
   

💻 使用示例

基礎用法

# 初始化上下文文件
cp data/personal_context.json.example data/personal_context.json

高級用法

# 更新上下文
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 文件以獲取詳細信息。

感謝您的支持！如需幫助或反饋，請隨時與我們聯繫。