MCP-PIF

🚀 模型上下文协议 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 智能如何通过结构化交互发展的机会。每一次会话都是发现新的理解和协作模式的机会。