MCP-PIF互动框架

@hungryrobot1/MCP-PIF

0 Stars 354 次浏览 hungryrobot1 更新于 2026-08-23

该服务器实现了模型上下文协议，通过结构化工具和渐进式的交互模式，促进人类与人工智能之间有意义的互动和理解发展。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：logging.level、workspaceRoot

服务介绍

Model Context Protocol TypeScript 实现

概述

该项目实现了Model Context Protocol (MCP)，作为Personal Intelligence Framework (PIF)的一个实际体现。通过结构化的工具和渐进的交互模式，它为人类和AI之间有意义的理解发展创造了空间。

快速开始

前提条件

Node.js 18+ 和 npm
TypeScript 5.0+
Model Context Protocol TypeScript SDK
配置了自定义服务器的Claude桌面客户端

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

设置

克隆仓库：

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

安装依赖项：

npm install

配置服务器：
- 默认情况下配置现在是自动检测的，但您可以自定义：
  - 设置MCP_WORKSPACE_ROOT环境变量以指定工作区位置
  - 或者设置带有配置选项JSON字符串的MCP_CONFIG环境变量
  - 或直接编辑src/config.ts修改默认配置
构建服务器：

npm run build

配置Claude桌面客户端：
- 找到您的Claude桌面客户端配置目录
- 创建或修改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替换为您实际的仓库路径
- 路径会根据您的操作系统自动标准化
连接Claude桌面客户端：
- 启动或重启Claude桌面客户端
- 选择“mcp-pif”作为您的自定义服务器
- 开始一个新的聊天以开始使用服务器

目录结构

服务器将在您配置的工作区内创建并管理以下结构：

workspace/
├── home/
│   ├── meta/
│   │   └── journal/     # For storing journal entries
│   └── projects/        # For user projects

下一步

查看模块文档了解可用工具
探索架构指南了解实现细节
检查开发指南获取贡献指南

故障排除

如果手动指定路径，请使用适合平台的分隔符（Windows上使用反斜杠，macOS/Linux上使用正斜杠）
如果连接失败，请检查Claude桌面客户端日志
确认您的工作区目录存在且可写
确保Node.js和TypeScript版本符合要求

核心实现

可用工具

该实现提供了一套旨在支持结构化交互的核心工具：

文件系统操作：导航和管理工作区上下文
- pwd, cd, read, write, mkdir, delete, move, rename
推理工具：创建结构化思考的空间
- reason：发展关联的见解
- think：创建用于沉思的时间空间
日志系统：保持框架的连续性
- journal_create：记录发展
- journal_read：探索模式

基本用法

// Create a structured thought pattern
reason: {
    thoughts: [
        { content: "Initial observation" },
        {
            content: "Building on previous thought",
            relationType: "sequence",
            relationTo: 0
        }
    ]
}

// Document development
journal_create: {
    title: "Implementation Pattern",
    content: "Insights about development...",
    tags: ["development", "patterns"]
}

跨平台支持

MCP-PIF 服务器设计为在 Windows、macOS 和 Linux 环境下无缝工作：

路径处理

所有文件路径都会根据当前操作系统自动标准化
根据当前环境自动检测工作区根目录
工作区内同时支持绝对路径和相对路径

配置

环境变量提供了一种跨平台的方式来配置服务器
文件操作使用 Node.js 路径方法以确保一致的行为
日志条目和其他数据存储在与平台无关的格式中

开发工作流

NPM 脚本在所有平台上都能工作
TypeScript 编译生成与平台无关的 JavaScript
错误处理考虑了特定于平台的文件系统行为

实现框架

模块架构

系统围绕着创建结构化涌现条件的模块化工具构建：

src/
├── core/          # Framework foundations
├── mcp_modules/   # Tool implementations
└── api/           # External integrations

工具模式

每个工具遵循一致的模式，同时保持其独特的作用：

清晰的接口定义
结构化的错误处理
状态管理
跨模块交互

开发环境

使用 TypeScript 保证类型安全
基于模块的组织
全面的日志记录
工作区上下文管理

理论基础

个人智能框架

PIF 代表了一种基于以下几点的人类-AI 协作的新方法：

创建结构化涌现的条件
维持基于框架的连续性
支持渐进式开发
启用有意义的互动

结构化涌现

实现不是规定固定的模式，而是通过创建有限的空间，在其中理解可以通过以下方式涌现：

工具中介的互动
关系结构
时间空间
渐进式开发

基于框架的连续性

理解通过以下方式发展：

结构化的文档
模式发现
历史背景
进化发展

逐步披露

系统支持不同层次的参与：

即时实用
模式发现
框架演变
哲学对齐

开发路径

工具用户

对于主要对实际应用感兴趣的用户：

从基本工具使用开始
探索模块文档
发展交互模式
发现新兴能力

框架开发者

对于有兴趣扩展系统的用户：

审查模块架构
理解工具模式
实现新功能
保持框架一致性

理论探索者

对于那些对更深层次模式感兴趣的人：

学习实现原则
观察新兴模式
贡献于框架的演进
发展新的理解

贡献

该项目欢迎在实现和理论方面都参与的贡献：

工具开发
文档改进
模式发现
框架演进

文档

提供全面的文档：

模块文档：单独工具文档
架构指南：系统设计和模式
开发指南：实现模式

未来方向

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

新工具开发
模式发现
框架优化
社区参与

哲学

这种实现体现了这样一种观点，即：

通过结构化的交互产生理解
工具为新模式创造空间
开发本身成为哲学探究
人类与人工智能智能共同进化

使用说明

该系统不仅仅是一套工具——它是一个探索人类和人工智能如何通过结构化交互发展的空间。每次会话都是发现新的理解和协作模式的机会。

查看源码项目主页