Model Context Protocol TypeScript Implementation
2025.03.19
22
TypeScript结构化交互AI协作开发框架开发效率交流协作
MCP-PIF是一个基于TypeScript实现的模型上下文协议（Model Context Protocol）项目，作为个人智能框架（Personal Intelligence Framework）的实践体现。它通过结构化的工具和渐进式的交互模式，为人类和AI之间创建有意义的发展空间。该项目支持跨平台操作，包括Windows、macOS和Linux环境，并提供了一系列核心工具来支持结构化交互。
View on GitHub
Overview
基本能力
产品定位
MCP-PIF是一个用于人类和AI之间结构化交互的开发框架，旨在通过工具和模式创建理解和协作的空间。
核心功能
- 文件系统操作：导航和管理工作区上下文，包括
pwd、cd、read、write、mkdir、delete、move、rename等命令。 - 推理工具：创建结构化思维空间，如
reason用于发展连接性见解，think用于创建临时思考空间。 - 日志系统：维护框架连续性，包括
journal_create用于记录发展，journal_read用于探索模式。 - 跨平台支持：自动处理路径规范化，支持Windows、macOS和Linux环境。
适用场景
- 人类与AI的协作开发
- 结构化思维和模式发现
- 渐进式理解和框架演化
- 跨平台开发环境
工具列表
- 文件系统操作工具：用于工作区文件管理。
- 推理工具：支持结构化思维和模式发现。
- 日志系统工具：用于记录和探索开发模式和见解。
常见问题解答
- 路径问题：确保使用平台适当的路径分隔符。
- 连接失败：检查Claude Desktop Client日志。
- 工作区权限：确保工作区目录存在且可写。
- 版本要求：确保Node.js和TypeScript版本符合要求。
使用教程
使用依赖
- Node.js 18+和npm
- TypeScript 5.0+
- Model Context Protocol TypeScript SDK
- 配置为自定义服务器的Claude Desktop Client
安装教程
- 克隆仓库：
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 Client：
- 修改
claude_desktop_config.json文件，指定服务器路径和参数 - 连接Claude Desktop Client：
- 启动或重启客户端
- 选择"mcp-pif"作为自定义服务器
- 开始新聊天以使用服务器
调试方式
- 检查Claude Desktop Client日志
- 验证工作区目录权限
- 确认Node.js和TypeScript版本
- 使用平台适当的路径分隔符