STARWARCLOUD STARWAR.AI
返回市场
百分比-MCP服务器

百分比-MCP服务器

作者：mikhashev2 星标更新：2025-04-12
安装使用来源：spider==github.com

项目介绍

个人上下文技术MCP服务器

此仓库使用模型上下文协议（MCP）实现了一个用于个人上下文技术（PCT）的服务器。它使像Claude这样的AI助手能够访问并更新您的个性化上下文数据，从而在会话之间创建持久记忆。

什么是个人上下文技术？

个人上下文技术允许您结构化和管理AI助手可以使用的个人数据，以提供更个性化和相关的响应。通过PCT：

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

特性

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

演示

观看个人上下文技术MCP服务器演示：

PCT 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
  1. 安装依赖
npm install
  1. 构建服务器
npm run build
  1. 启动服务器
npm start

连接到Claude桌面

要使用此服务器与Claude桌面配合使用：

Windows

  1. 打开Claude桌面
  2. 导航到设置 > 开发者 > 编辑配置
  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桌面
  2. 导航到设置 > 开发者 > 编辑配置
  3. 这将打开~/Library/Application Support/Claude Desktop/目录
  4. 创建或编辑claude_desktop_config.json，内容如下：
{
  你的配置内容
}

Linux

  1. 打开Claude桌面
  2. 导航到设置 > 开发者 > 编辑配置
  3. 这将打开~/.config/Claude Desktop/目录
  4. 创建或编辑claude_desktop_config.json，内容如下：
{
  你的配置内容
}

使用个人上下文服务器

与Claude桌面一起使用

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

访问上下文数据

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

  1. 完整上下文：选择“所有部分”以让Claude访问您的整个个人上下文
  2. 基于部分：选择特定部分（基本信息、偏好等）以仅分享上下文的某些部分

示例提示：“使用我的上下文数据，推荐一些符合我学习风格的学习资源。”

更新上下文数据

您可以使用updateContext工具更新个人上下文：

示例提示：“更新我的偏好中的learning_style为‘视觉和动手’，因为我发现我通过实践例子学得更好。”

自定义您的上下文

默认的个人上下文包括：

  • 基本信息：姓名、位置等
  • 偏好：沟通风格、学习偏好等
  • 指令：AI应如何使用和更新您的上下文的规则
  • 元数据：版本跟踪、更新历史

您可以通过编辑src/storage/contextStorage.ts中的DEFAULT_CONTEXT对象来修改默认结构。 或者只需替换更新文件数据[PATH_TO_YOUR_PROJECT/pct-mcp-server/data/personal_context.json]来自仓库模板数据（https://github.com/mikhashev/personal-context-manager/blob/main/use-cases/self-education/personal_context_self_education_template.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文件（git忽略）
# node_modules/                # 依赖（git忽略）
# data/                        # 用户数据（git忽略或仅包含样本）
#   └── personal_context.json  # 个人上下文数据（仅样本）（不要更改文件名personal_context.json，如有需要更新数据）

高级配置

使用HTTP传输

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

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

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

多用户支持

为了支持多用户，修改contextStorage.js文件，根据用户ID将上下文存储在用户特定的文件中。

贡献

欢迎贡献！请随时提交拉取请求。

许可证

本项目发布在MIT许可证下 - 查看LICENSE以了解涵盖项目的许可。

致谢

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