MCP-PIF

Model Context Protocol TypeScript Implementation

Overview: This project implements the Model Context Protocol (MCP) as a practical embodiment of the Personal Intelligence Framework (PIF), creating spaces for meaningful human-AI understanding through structured tools and interaction patterns.

Quick Start: Requires Node.js 18+, TypeScript 5.0+, and a configured Claude Desktop Client. Clone the repository, install dependencies, configure the server via environment variables or src/config.ts, and build using npm run build. Configure the Claude Desktop Client to connect to the server.

Core Implementation: Provides tools for filesystem operations (pwd, cd, etc.), reasoning (reason, think), and a journal system (journal_create, journal_read).

Cross-Platform Support: Designed for Windows, macOS, and Linux with automatic path normalization and environment variable-based configuration.

Implementation Framework: Uses a modular architecture with core, mcp_modules, and api directories.

Theoretical Foundation: Based on the PIF, emphasizing structured emergence, framework-based continuity, and progressive disclosure.

Contributing: Welcomes contributions to tool development, documentation, pattern discovery, and framework evolution.