mcpserver.so LogoMCPFly
Submit
mcp-prompts-rs logo

mcp-prompts-rs

by sparesparrow

AI/ManagementAI PromptsRustServerPrompt Management

mcp-prompts-rs is a Rust-based server for managing AI prompts using the Model Context Protocol (MCP). It provides functionality for storing, retrieving, and managing AI prompts with support for template variables, categorization, and multiple storage backends.

View on GitHub

Last updated: N/A

mcp-prompts-rs

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

Overview

mcp-prompts-rs is a Rust implementation of a prompt management server that adheres to the Model Context Protocol (MCP), an open standard for connecting AI applications to data sources and tools. This project is a Rust rewrite of the original mcp-prompts TypeScript implementation.

The server provides functionality for storing, retrieving, and managing AI prompts with support for 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 file system and PostgreSQL storage options
  • API: RESTful endpoints with Server-Sent Events (SSE) for real-time updates
  • MCP Integration: Implements 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 for database storage

Setup

  1. Clone the repository:
git clone https://github.com/your-username/mcp-prompts-rs.git
cd mcp-prompts-rs
  1. Build the project:
cargo build

Usage

Running the Server

Start the server with default settings:

cargo run

With custom configuration:

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

CLI Options

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

Integration with Claude

To integrate with Claude Desktop:

  1. Open Claude Desktop
  2. Go to Settings → Developer → Edit Config
  3. Add the following to your configuration:
{
  "mcp": {
    "servers": [
      {
        "name": "mcp-prompts-rs",
        "url": "http://localhost:8080"
      }
    ]
  }
}

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 utilities

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your 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