Prompt Manager

🚀 MCP-Prompts Server

MCP-Prompts is a powerful prompt manager that supports resource attachments, version control, and team collaboration. This guide provides detailed instructions on how to integrate MCP-Prompts with other services using Docker Compose.

🚀 Quick Start

📦 Installation

You can integrate MCP-Prompts with other services using Docker Compose. Here is a complete docker-compose.yml file example:

version: '3.8'

services:
  mcp-prompts:
    image: sparesparrow/mcp-prompts:latest
    environment:
      - ENABLE_RESOURCES=true
      - STORAGE_TYPE=file
      - PROMPTS_DIR=/app/data/prompts
      - HTTP_SERVER=true
      - PORT=3003
      - HOST=0.0.0.0
    volumes:
      - ./data:/app/data
    ports:
      - "3003:3003"

  mcp-mermaid:
    image: mcp/mermaid-server:latest
    ports:
      - "3004:3004"

  mcp-orchestrator:
    image: mcp/orchestrator-server:latest
    ports:
      - "3005:3005"

  mcp-filesystem:
    image: mcp/filesystem-server:latest
    volumes:
      - ./data:/data
    ports:
      - "3006:3006"

  postgres-db:
    image: postgres:14
    environment:
      - POSTGRES_USER=mcp
      - POSTGRES_PASSWORD=mcp_password
      - POSTGRESS_DB=mcp_prompts
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

💻 Usage Examples

Basic Usage

To start the MCP-Prompts server with SSE support, use the following command:

docker-compose up mcp-prompts-sse

This command will start the MCP-Prompts server on port 3003 and enable SSE functionality. The SSE endpoint is located at /events.

Advanced Usage

To configure Claude Desktop to use the Dockerized MCP-Prompts server with SSE support, update your claude_desktop_config.json file (usually located at ~/.config/Claude/claude_desktop_config.json):

"prompts": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-p",
    "3003:3003",
    "-v",
    "/path/to/your/prompts:/app/data/prompts",
    "-v",
    "/path/to/your/backups:/app/data/backups",
    "--name",
    "mcp-prompts-sse",
    "-e",
    "STORAGE_TYPE=file",
    "-e",
    "PROMPTS_DIR=/app/data/prompts",
    "-e",
    "HTTP_SERVER=true",
    "-e",
    "PORT=3003",
    "-e",
    "HOST=0.0.0.0"
  ]
}

🔧 Technical Details

Server-Sent Events (SSE) Support

MCP-Prompts now supports Server-Sent Events (SSE), which enables real-time reception of prompt updates. This is particularly useful for real-time applications like the Claude Desktop application.

Supported Event Types

1. Create Prompt

   {
     "event": "prompt_created",
     "data": {
       "id": "string",
       "name": "string",
       "content": "string",
       "timestamp": "number"
     }
   }
   

2. Update Prompt

   {
     "event": "prompt_updated",
     "data": {
       "id": "string",
       "name": "string",
       "content": "string",
       "timestamp": "number"
     }
   }
   

3. Delete Prompt

   {
     "event": "prompt_deleted",
     "data": {
       "id": "string",
       "name": "string",
       "timestamp": "number"
     }
   }
   

Example: Subscribing to SSE Events

Here is an example of subscribing to SSE events using JavaScript:

const eventSource = new EventSource('/events');

eventSource.addEventListener('message', (e) => {
  console.log('New event:', e.data);
});

Listening for Specific Event Types

You can filter events by specifying the event type in the EventSource URL:

// Listen for prompt creation events
const createEventSource = new EventSource('/events?event=prompt_created');
createEventSource.addEventListener('message', (e) => {
  console.log('New prompt created:', e.data);
});

Summary

With Docker Compose, you can easily integrate MCP-Prompts with other services into a unified environment. Additionally, SSE support provides powerful functionality for real-time applications. We hope this guide helps you better understand and use MCP-Prompts and its related features.