Labsco
nicholasrubright logo

MCPatterns

★ 1

from nicholasrubright

A server for storing and retrieving personalized coding patterns from a local JSONL file.

🔥🔥✓ VerifiedFreeQuick setup
#automation#database#git#maps#memory

MCPatterns

MCPatterns is a Model Context Protocol (MCP) server that enables users to save and retrieve personalized coding patterns. It helps LLMs learn how an individual codes by storing structured patterns categorized by technology, use case, and style.

🧠 Purpose

This server acts as a persistent memory layer for LLM agents, allowing them to reference a user's preferred coding styles, patterns, and conventions. It supports:

  • Personalized code generation based on stored patterns
  • Consistent refactoring following user preferences
  • Style-aware suggestions using familiar patterns
  • Long-term memory of coding practices across sessions

🧩 MCP Integration

MCPatterns follows the Model Context Protocol specification, providing tools for creating, reading, updating, and deleting coding patterns. It uses JSONL (newline-delimited JSON) storage for atomic operations and data consistency.

🗂 Pattern Schema

interface Pattern {
  name: string;                              // Unique identifier
  category: string;                          // e.g., "Backend", "Frontend", "Database"
  description: string;                       // What this pattern does
  use_cases: string[];                       // When to use this pattern
  technologies: string[];                    // Languages, frameworks, libraries
  code_examples: { [language: string]: string }; // Code samples by language
}

Example Pattern

{
  "name": "Error Handling Middleware",
  "category": "Backend",
  "description": "Express middleware for consistent error handling with structured responses",
  "use_cases": ["API development", "Middleware composition", "Error standardization"],
  "technologies": ["Node.js", "Express", "TypeScript"],
  "code_examples": {
    "JavaScript": "app.use((err, req, res, next) => {\n  console.error(err.stack);\n  res.status(500).json({ error: 'Something went wrong!' });\n});",
    "TypeScript": "app.use((err: Error, req: Request, res: Response, next: NextFunction) => {\n  console.error(err.stack);\n  res.status(500).json({ error: 'Something went wrong!' });\n});"
  }
}

🔧 Available Tools

MCPatterns provides the following MCP tools:

create_patterns

Create multiple new coding patterns in the database.

Input:

{
  "patterns": [Pattern, ...]
}

add_code_examples

Add new code examples to existing patterns.

Input:

{
  "additions": [
    {
      "patternName": "string",
      "examples": { "language": "code" }
    }
  ]
}

delete_patterns

Delete multiple patterns by name.

Input:

{
  "patternNames": ["pattern1", "pattern2"]
}

delete_code_examples

Remove specific code examples from patterns.

Input:

{
  "deletions": [
    {
      "patternName": "string",
      "languages": ["JavaScript", "TypeScript"]
    }
  ]
}

read_patterns

Retrieve all stored patterns.

Input: None

search_patterns

Search patterns by query across all fields.

Input:

{
  "query": "search term"
}

open_patterns

Retrieve specific patterns by name.

Input:

{
  "names": ["pattern1", "pattern2"]
}

🗄 Storage

MCPatterns uses JSONL (newline-delimited JSON) format for data storage:

  • File location: Configurable via PATTERNS_FILE_PATH environment variable
  • Default location: patterns.json in the server directory
  • Format: Each line contains a JSON object with type: "pattern"
  • Atomic operations: Full file rewrite ensures data consistency

📜 License

MIT