Personal Context Technology MCP Server

个人上下文技术 MCP 服务

此仓库使用模型上下文协议（MCP）为个人上下文技术（PCT）实现了一个服务。它能让 Claude 等 AI 助手访问和更新你的个性化上下文数据，从而在不同会话之间保留记忆。

什么是个人上下文技术？

个人上下文技术让你能够构建和管理个人数据，供 AI 助手用来提供更个性化、更相关的回复。借助 PCT：

• 你的上下文会在 AI 会话之间保留
• 你可以控制数据的存储位置（本地、云端等）
• 你可以明确规定 AI 系统应如何使用你的数据
• 你可以根据偏好和情况的变化更新上下文

功能

• 持久化上下文存储：存储你的偏好、目标、学习风格及其他个人信息
• 隐私控制：指令块定义哪些信息为私密信息，哪些为公开信息
• 分区访问：访问完整上下文或单个分区
• 上下文更新：通过 updateContext 工具更新特定字段
• 版本跟踪：保留上下文变更历史

演示

观看个人上下文技术 MCP 服务的实际演示：

演示展示了如何：

• 使用 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": {}
    }
  }
}

使用个人上下文服务

搭配 Claude Desktop 使用

1. 使用 npm start 启动 PCT MCP 服务
2. 重启 Claude Desktop（如有需要）
3. 在 Claude 中，点击输入框内的 MCP 工具图标（扳手/工具图标）
4. 你会看到带有可用工具和资源的“personal-context-server”：
   • 资源：访问你的上下文数据（完整上下文或按分区访问）
   • 工具：更新上下文中的特定字段

访问上下文数据

Claude 可以通过两种方式访问你的个人上下文数据：

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 将上下文存储在各自的文件中。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目根据 MIT License 发布——请参阅涵盖本项目的 LICENSE。

致谢

本项目基于 Personal Context Technology 概念，并实现了由 Anthropic 开发的 Model Context Protocol（MCP），以便 AI 系统访问外部上下文。