MCP Prompts Rs

🚀 mcp-prompts-rs

A Rust-based server for managing AI prompts following the Model Context Protocol (MCP).

🚀 Quick Start

mcp-prompts-rs is a Rust rewrite of the mcp-prompts TypeScript project. This server provides functionalities to store, retrieve, and manage AI prompts, supporting template variables, categorization, and multiple storage backends.

✨ Features

• Prompt Management: Create, retrieve, update, and delete prompts with categorization.
• Template Support: Create prompts with variables for runtime customization.
• Storage Backends: Support for filesystem and PostgreSQL storage options.
• API: RESTful endpoints with Server-Sent Events (SSE) for real-time updates.
• MCP Integration: Implement the Model Context Protocol for seamless integration with AI assistants like Claude.
• Project Orchestration: Tools for automating software project creation using templates.
• Deployment: Docker support and health check endpoints.

📦 Installation

Prerequisites

• Rust 1.70 or higher
• Cargo (Rust's package manager)
• Optional: PostgreSQL database

Setup

1. Clone the repository:

git clone https://github.com/your-username/mcp-prompts-rs.git
cd mcp-prompts-rs

2. Build the project:

cargo build

💻 Usage Examples

Running the Server

Run the server with default settings:

cargo run

Run with custom configuration:

cargo run -- --port 3000 --storage filesystem

CLI Options

• --port <PORT>: Set the server port (default: 8080).
• --storage <TYPE>: Choose the storage backend (filesystem, postgres).
• --db-url <URL>: PostgreSQL connection string (when using postgres storage).
• --prompt-dir <DIR>: Prompt storage directory (when using filesystem storage).

Integration with Claude

To integrate with Claude Desktop:

1. Open Claude Desktop.
2. Go to Settings → Developer → Edit Configuration.
3. Add the following to your configuration:

{
  "mcp": {
    "servers": [
      {
        "name": "mcp-prompts-rs",
        "url": "http://localhost:8080"
      }
    ]
  }
}

📚 Documentation

API Endpoints

Prompts

• GET /prompts: List all prompts.
• GET /prompts/:id: Get a specific prompt.
• POST /prompts: Create a new prompt.
• PUT /prompts/:id: Update an existing prompt.
• DELETE /prompts/:id: Delete a prompt.

SSE

• GET /events: Server-Sent Events endpoint for real-time updates.

Development

Project Structure

• src/main.rs: Entry point and server setup.
• src/prompt/: Prompt models and logic.
• src/storage/: Storage backend implementations.
• src/api/: API endpoint handlers.
• src/template/: Template processing tools.

Building from Source

cargo build

Running Tests

cargo test

Docker Support

Build and run with Docker:

docker build -t mcp-prompts-rs .
docker run -p 8080:8080 mcp-prompts-rs

Contribution

Contributions are welcome! Feel free to submit a Pull Request.

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Acknowledgments

• The original mcp-prompts TypeScript project.
• Model Context Protocol.
• Rust SDK for MCP.