Prompt Library MCP Server

A Laravel application that provides a unified prompt library accessible through the Model Context Protocol (MCP). Access Fabric's 200+ curated patterns, create custom prompts, or sync from other repositories. All through a single, searchable library.

Key Features

• Unified Prompt Library: Single interface for all prompt types (Fabric patterns, custom prompts, external sources)
• Simple Web Interface: Web UI for creating and managing custom prompts
• MCP Server Powered by Laravel Loop: Compatible with any MCP-enabled client (Claude Desktop, Cursor, Windsurf, etc.)

Installation

Prerequisites

• PHP 8.2 or higher
• Composer
• Laravel 12.x
• SQLite (default) or your preferred database

Setup

1. Clone and install dependencies:

git clone <repository-url> prompts-mcp
cd prompts-mcp
composer install

2. Configure environment:

cp .env.example .env
php artisan key:generate

3. Initialize database:

php artisan migrate

4. Sync Fabric patterns:

php artisan prompts:sync --source=fabric

Usage

MCP Integration

Once configured, your AI client gains access to these unified tools:

Core Tools

• compose_prompt - Compose any prompt (Fabric or custom) with user input
  • Parameters: prompt_name (required), input_content, additional_context

Discovery Tools

• search_prompts - Search across all prompt sources
• list_categories - List categories with prompt counts
• list_prompts_by_category - Browse by category
• list_all_prompts - Complete prompt catalog
• get_prompt_details - Detailed prompt information

Example Usage in Claude Desktop

1. Use a Fabric pattern:

   Use the analyze_claims prompt on this article: [paste content]
   

2. Use a custom prompt:

   Use my-custom-analysis with this data: [paste content]
   

3. Browse available prompts:

   List all prompts in the writing category
   

4. Search prompts:

   Search for prompts related to "code review"
   

Connecting to AI Clients

Claude Desktop

1. Generate configuration:

   php artisan loop:mcp:generate-config

2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "prompt-library": {
         "transport": "sse",
         "url": "http://your-app-url/mcp/sse"
       }
     }
   }

3. Restart Claude Desktop

Cursor

{
  "mcpServers": {
    "prompt-library": {
      "command": "php",
      "args": ["/path/to/your/project/artisan", "loop:mcp:start"]
    }
  }
}

Prompt Sources

Fabric Patterns (Automatic)

• 200+ official patterns from danielmiessler/fabric
• Automatically categorized and tagged
• Synced via php artisan prompts:sync --source=fabric

Custom Prompts (Manual)

• Create through web interface
• Full control over content, categorization, and visibility
• Support for template variables ({{INPUT}}, $INPUT)

Future Sources

The architecture supports additional sources:

• GitHub repositories with similar structure
• API-based prompt services
• Imported prompt collections

Web Interface

Visit your application URL to access the prompt library:

• Browse Library: View all prompts with filtering by source, category, and search
• Create Custom Prompts: Simple form with title, description, content, and categorization
• Manage Prompts: Edit and organize your custom prompts

Commands

Prompt Management

# Sync from external sources
php artisan prompts:sync --source=fabric
php artisan prompts:sync --source=all --force

# Generate MCP client configuration
php artisan loop:mcp:generate-config

# Start STDIO MCP server
php artisan loop:mcp:start

Creating Custom Prompts

Via Web Interface:

1. Visit /prompts/create
2. Fill in title, description, content, and category
3. Use template variables like {{INPUT}} for user content
4. Set visibility (public/private)

Via Code:

use App\Services\PromptService;

$promptService = app(PromptService::class);
$prompt = $promptService->createManualPrompt([
    'title' => 'My Custom Prompt',
    'description' => 'Analyzes marketing copy',
    'content' => 'You are a marketing expert. Analyze: {{INPUT}}',
    'category' => 'analysis',
    'tags' => ['marketing', 'analysis'],
    'is_public' => true,
]);

Architecture

Unified Data Model

• Single prompts table stores all prompt types
• source_type field differentiates: 'manual', 'fabric', 'github'
• Consistent API across all prompt sources

MCP Integration

Built on Laravel Loop:

1. Unified toolkit exposes all prompts through same interface
2. Source-aware - indicates prompt origin in responses
3. Usage tracking - monitors prompt composition for analytics

Troubleshooting

Common Issues

"No prompts found"

• Run php artisan prompts:sync --source=fabric to sync Fabric patterns
• Check web interface at /prompts to verify prompts exist

"MCP connection failed"

• Ensure Laravel server is running
• Verify MCP endpoint URL in client configuration
• Check authentication if enabled

"Tool not found"

• Prompt names use exact format from prompt library
• Use search_prompts to find available prompts
• Check web interface for correct prompt names