Pinthepiece

🚀 PinThePiece MCP Server

A robust Model Context Protocol (MCP) server that offers a feature-rich note management system. This server implements an advanced note storage solution that emphasizes data integrity, organization, and easy accessibility. Key features include hierarchical storage, atomic operations, version control support, automatic backup, and comprehensive search capabilities.

🚀 Quick Start

📦 Installation

MacOS

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json%

✨ Features

📒 Note Storage System

The server implements an advanced note storage system with the following features:

• Hierarchical storage structure to enhance organization and scalability
• Atomic file operations to ensure data integrity
• Version control and metadata support
• Automatic backup
• Concurrent access handling
• Comprehensive logging

📂 Storage Structure

~/.pinthepiece/
├── notes/
│   ├── data/
│   │   └── YEAR/
│   │       └── MONTH/
│   │           └── note-name.json
│   ├── backups/
│   │   └── note-name.json.TIMESTAMP.bak
│   └── index.json
└── logs/
    └── notes.log

📝 Note Format

Each note is stored as a JSON file, containing:

• Content: The main text content of the note
• Creation/modification timestamps
• Classification tags
• Optional description
• Metadata, including:
  • Format version
  • Last backup timestamp
  • Content checksum

📚 Resources

The server implements a note storage system with:

• A custom note:// URI scheme for accessing individual notes
• Each note resource has:
  • Name: A unique identifier
  • Content: The main text content
  • Description: An optional description
  • Tags: A list of classification tags
  • Metadata: Version and integrity information
  • MIME type: text/plain

🔒 Data Security Features

• Atomic Operations: All file writes use atomic operations to prevent corruption.
• Backup System: Automatic backups are available for reference before modifications.
• Version Control: File format version control ensures future compatibility.
• Data Validation: Checksum validation and integrity checks are performed.
• Concurrent Access: File locking guarantees thread safety.
• Error Recovery: Transaction-like operations with rollback functionality are supported.

💡 Prompt Statements

The server provides a single prompt:

• summarize-notes: Create a summary of all stored notes.
  • An optional "style" parameter can be used to control the level of detail (concise/detailed).
  • Generate a prompt containing the content of all current notes based on style preferences.

🛠️ Tools

The server implements a tool:

• add-note: Add a new note to the server.
  • Accept "name" and "content" as required string parameters.
  • Optional "tags" and "description" parameters are available.
  • Update the server state and notify the client of resource changes.
  • Perform atomic file operations and create backups.

📚 Documentation

📍 Storage Location

By default, the server stores notes in:

• ~/.pinthepiece/notes/ - The main storage directory
• ~/.pinthepiece/logs/ - Log files

📃 Logging

• Detailed logs of all operations are recorded.
• Log rotation is used to manage space.
• Both file and console log outputs are provided.
• The log level is configurable.

❌ Error Handling

The server implements comprehensive error handling:

• Detailed error logs with stack traces are provided.
• Temporary files are automatically cleaned up.
• Interrupted operations can be resumed.
• Backup restoration capabilities are available.
• Data validation is performed during loading/saving.