模型上下文协议 TypeScript 实现

概述

本项目实现了模型上下文协议（MCP）作为个人智能框架（PIF）的实际体现。通过结构化的工具和渐进式交互模式，它为人类与 AI 之间的有意义理解发展创造了空间。

快速开始

先决条件

• Node.js 18+ 和 npm
• TypeScript 5.0+
• 模型上下文协议 TypeScript SDK
• 已配置的 Claude Desktop 客户端用于自定义服务器

注意：此实现已在 Windows 和 macOS/Linux 系统上进行了测试。

设置

1. 克隆仓库：

git clone [https://github.com/hungryrobot1/MCP-PIF]
cd mcp-pif

2. 安装依赖项：

npm install

3. 配置服务器：

   • 由默认自动检测配置，但可以自定义：
     • 设置 MCP_WORKSPACE_ROOT 环境变量以指定工作区位置
     • 或设置 MCP_CONFIG 环境变量为配置选项的 JSON 字符串
     • 或直接编辑 src/config.ts 以修改默认配置

4. 构建服务器：

npm run build

5. 配置 Claude Desktop 客户端：

   • 找到您的 Claude Desktop 客户端配置目录
   • 创建或修改 claude_desktop_config.json：

     {
         "mcpServers": {
             "mcp-pif": {
                 "command": "node",
                 "args": ["path/to/your/mcp-pif/build/index.js"],
                 "cwd": "path/to/your/mcp-pif",
                 "env": {}
             }
         }
     }
     

   • 替换 path/to/your/mcp-pif 为您的实际仓库路径
   • 路径会自动根据您的操作系统进行调整

6. 连接 Claude Desktop 客户端：

   • 启动或重新启动 Claude Desktop 客户端
   • 在服务器选项中选择“添加新服务器”
   • 输入以下信息：
     • 名称：MCP-PIF
     • 类型：WebSocket
     • 地址：ws://localhost:3001

工具使用示例

• 创建基础上下文：

const context = new Context();
context.addEntity("Alice", "一个人");
context.addEntity("Bob", "另一个人");
context.addRelationship("Alice", "knows", "Bob");

• 查询上下文：

const query = new Query("谁认识 Bob?");
query.execute(context);

理论基础

个人智能框架（PIF）

基于以下原则的新颖方法：

• 创造条件以实现结构化涌现
• 维持框架连续性
• 支持渐进式发展
• 实现有意义的协作

结构化涌现

通过以下方式避免固定模式，创建有界空间：

• 工具中介交互
• 关系结构
• 时间空间
• 渐进式发展

框架连续性

理解通过以下方式发展：

• 结构化记录
• 模式发现
• 历史上下文
• 进化发展

未来方向

项目通过以下方式继续发展：

• 新工具开发
• 模式发现
• 框架完善
• 社区参与

哲学

此实现体现了以下观点：

• 理解通过结构化交互中涌现
• 工具为新模式创造空间
• 发展本身就是哲学探究
• 人类与 AI 智能共同进化

注意事项

该系统不仅是工具集合，更是探索人类与 AI 智能如何通过结构化交互发展的机会。每一次会话都是发现新的理解和协作模式的机会。