个人情境技术 MCP 服务器

本仓库实现了使用模型情境协议 (MCP) 的 个人情境技术 (PCT) 服务器。它使像 Claude 这样的人工智能助手能够访问和更新您的个性化情境数据，从而在会话之间创建持久的记忆。

什么是个人情境技术？

个人情境技术允许您构建和管理个人数据，人工智能助手可以使用这些数据来提供更个性化和相关的响应。使用 PCT：

• 您的情境在 AI 会话之间得以保留
• 您可以控制数据的存储位置（本地、云等）
• 您可以为 AI 系统应如何使用您的数据定义明确的指令
• 您可以根据您的偏好和情况变化来更新情境

功能

• 持久情境存储：存储您的偏好、目标、学习风格和其他个人信息
• 隐私控制：指令块定义哪些信息是私有的/公共的
• 基于部分访问：访问完整情境或各个部分
• 情境更新：通过 updateContext 工具更新特定字段
• 版本跟踪：维护情境更改的历史记录

安装

前提条件

• 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 仓库数据
├── .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 文件 (gitignored)
# node_modules/                # 依赖 (gitignored)
# data/                        # 用户数据 (gitignored 或仅包含示例)
#   └── personal_context.json  # 个人情境数据（仅示例）（不要更改文件名 personal_context.json，如果需要，更新数据）

高级配置

使用 HTTP 传输

默认实现使用 stdio 传输进行开发。对于生产用途，您可以切换到 HTTP 传输：

1. 编辑 src/index.ts
2. 取消注释 HTTP 传输部分
3. 配置您所需的端口和 CORS 设置
4. 重新构建并重启服务器

! 我建议始终在您的机器上本地开发时使用 stdio 传输。

多用户支持

要支持多个用户，请修改 contextStorage.js 文件以基于用户 ID 将情境存储在用户特定的文件中。

贡献

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

许可证

本项目根据 LICENSE 发布，该许可证涵盖了本项目。

致谢

本项目基于个人情境技术概念，并实现了 Anthropic 开发的模型情境协议 (MCP)，以使 AI 系统能够访问外部情境。