MCP PIF

🚀 Model Context Protocol TypeScript Implementation

This project implements the Model Context Protocol (MCP) as a practical manifestation of the Personal Intelligence Framework (PIF). Through structured tools and progressive interaction patterns, it creates space for the development of meaningful understanding between humans and AI.

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• TypeScript 5.0+
• Model Context Protocol TypeScript SDK
• A configured Claude Desktop client for the custom server

⚠️ Important Note

This implementation has been tested on Windows and macOS/Linux systems.

Setup

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Configure the server:

   • It is automatically detected and configured by default, but can be customized:
     • Set the MCP_WORKSPACE_ROOT environment variable to specify the workspace location.
     • Or set the MCP_CONFIG environment variable to a JSON string of configuration options.
     • Or directly edit src/config.ts to modify the default configuration.

4. Build the server:

npm run build

5. Configure the Claude Desktop client:

   • Find your Claude Desktop client configuration directory.
   • Create or modify 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": {}
             }
         }
     }
     

   • Replace path/to/your/mcp-pif with your actual repository path.
   • The path will be automatically adjusted according to your operating system.

6. Connect the Claude Desktop client:

   • Start or restart the Claude Desktop client.
   • Select "Add New Server" in the server options.
   • Enter the following information:
     • Name: MCP-PIF
     • Type: WebSocket
     • Address: ws://localhost:3001

💻 Usage Examples

Basic Usage

• Create a basic context:

const context = new Context();
context.addEntity("Alice", "一个人");
context.addEntity("Bob", "另一个人");
context.addRelationship("Alice", "knows", "Bob");

• Query the context:

const query = new Query("谁认识 Bob?");
query.execute(context);

📚 Documentation

Personal Intelligence Framework (PIF)

A novel approach based on the following principles:

• Create conditions for structured emergence.
• Maintain framework continuity.
• Support progressive development.
• Enable meaningful collaboration.

Structured Emergence

Create a bounded space by avoiding fixed patterns through:

• Tool-mediated interaction.
• Relational structure.
• Time and space.
• Progressive development.

Framework Continuity

Understanding develops through:

• Structured records.
• Pattern discovery.
• Historical context.
• Evolutionary development.

🔮 Future Directions

The project will continue to evolve through:

• Development of new tools.
• Pattern discovery.
• Framework improvement.
• Community participation.

📖 Philosophy

This implementation reflects the following views:

• Understanding emerges from structured interactions.
• Tools create space for new patterns.
• Development itself is a philosophical inquiry.
• Human and AI intelligence co-evolve.

⚠️ Important Note

This system is not just a collection of tools but an opportunity to explore how human and AI intelligence can develop through structured interactions. Each session is an opportunity to discover new patterns of understanding and collaboration.