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 智能如何通過結構化交互發展的機會。每一次會話都是發現新的理解和協作模式的機會。