🚀 模型上下文协议 TypeScript 实现
本项目实现了模型上下文协议（MCP），它是个人智能框架（PIF）的实际体现。借助结构化的工具和渐进式交互模式，该项目为人类与 AI 之间达成有意义的理解创造了条件。
🚀 快速开始
先决条件
- Node.js 18+ 和 npm
- TypeScript 5.0+
- 模型上下文协议 TypeScript SDK
- 已配置的 Claude Desktop 客户端用于自定义服务器
⚠️ 重要提示
此实现已在 Windows 和 macOS/Linux 系统上进行了测试。
设置
- 克隆仓库：
git clone [https://github.com/hungryrobot1/MCP-PIF]
cd mcp-pif
- 安装依赖项：
npm install
- 配置服务器： 默认情况下会自动检测配置，但您也可以进行自定义：
- 设置
MCP_WORKSPACE_ROOT环境变量以指定工作区位置。 - 或者设置
MCP_CONFIG环境变量为配置选项的 JSON 字符串。 - 也可以直接编辑
src/config.ts来修改默认配置。
- 构建服务器：
npm run build
- 配置 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替换为您的实际仓库路径，路径会根据您的操作系统自动调整。
- 连接 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 智能如何通过结构化交互发展的机会。每一次会话都是发现新的理解和协作模式的机会。