# MCP-PIF

> MCP Server

This repository implements the Model Context Protocol (MCP) as part of the Personal Intelligence Framework (PIF), creating spaces for meaningful AI-human understanding through structured tools and interaction patterns.

## Overview

- **Category:** AI
- **Language:** TypeScript
- **Stars:** 57
- **Forks:** 4
- **Owner:** hungryrobot1
- **GitHub:** https://github.com/hungryrobot1/MCP-PIF
- **Created:** 2025-01-29T02:59:09+00:00
- **Updated:** 2025-03-24T09:00:28+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-personal-intelligence-framework-implementation

## Setup

## Setup

1. Clone the repository:
```bash
git clone [https://github.com/hungryrobot1/MCP-PIF]
cd mcp-pif
```

2. Install dependencies:
```bash
npm install
```

3. Configure the server:
   - Configuration is now auto-detected by default, but you can customize:
     - Set the `MCP_WORKSPACE_ROOT` environment variable to specify a workspace location
     - Or set the `MCP_CONFIG` environment variable with a JSON string of configuration options
     - Or directly edit `src/config.ts` to modify the default configuration

4. Build the server:
```bash
npm run build
```

5. Configure Claude Desktop Client:
   - Locate your Claude Desktop Client configuration directory
   - Create or modify `claude_desktop_config.json`:
     ```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
   - Paths are automatically normalized for your operating system

6. Connect Claude Desktop Client:
   - Start or restart the Claude Desktop Client
   - Select "mcp-pif" as your custom server
   - Start a new chat to begin using the server

## Tools

## Available Tools

1.  Filesystem Operations (Navigate and manage workspace context)
2.  Reasoning Tools (Create spaces for structured thought)
3.  Journal System (Maintain framework continuity)
4.  `pwd` (Navigate and manage workspace context)
5.  `cd` (Navigate and manage workspace context)
6.  `read` (Navigate and manage workspace context)
7.  `write` (Navigate and manage workspace context)
8.  `mkdir` (Navigate and manage workspace context)
9.  `delete` (Navigate and manage workspace context)
10. `move` (Navigate and manage workspace context)
11. `rename` (Navigate and manage workspace context)
12. `reason` (Develop connected insights)
13. `think` (Create temporal spaces for contemplation)
14. `journal_create` (Document developments)
15. `journal_read` (Explore patterns)