🚀 mcp-prompts-rs

mcp-prompts-rs 是一个基于 Rust 的服务器，用于管理遵循 Model Context Protocol (MCP) 的 AI 提示。它能帮助用户高效地存储、检索和管理 AI 提示，支持模板变量、分类以及多种存储后端，为 AI 提示管理提供了强大而灵活的解决方案。

🚀 快速开始

mcp-prompts-rs 是 mcp-prompts TypeScript 项目的 Rust 重写版本。该服务器提供了存储、检索和管理 AI 提示的功能，支持模板变量、分类以及多种存储后端。

✨ 主要特性

• 提示管理：可创建、获取、更新和删除提示，还带有分类功能，方便用户对提示进行有序管理。
• 模板支持：允许使用变量创建提示，以便在运行时进行自定义，满足不同场景的需求。
• 存储后端：支持文件系统和 PostgreSQL 两种存储选项，用户可根据自身需求灵活选择。
• API：带有 Server-Sent Events (SSE) 的 RESTful 端点，能够实现实时更新，确保数据的及时性。
• MCP 集成：实现了 Model Context Protocol，可与 AI 助手（如 Claude）无缝集成，拓展了应用场景。
• 项目编排：提供使用模板自动化软件项目创建的工具，提高项目创建效率。
• 部署：支持 Docker 部署，并且提供健康检查端点，方便进行部署和监控。

📦 安装指南

先决条件

• Rust 1.70 或更高版本
• Cargo（Rust 的包管理器）
• 可选：PostgreSQL 数据库

设置

1. 克隆仓库：

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

2. 构建项目：

cargo build

💻 使用示例

运行服务器

基础用法

使用默认设置运行服务器：

cargo run

高级用法

使用自定义配置运行：

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

CLI 选项

• --port <PORT>：设置服务器端口（默认：8080）
• --storage <TYPE>：选择存储后端（filesystem, postgres）
• --db-url <URL>：PostgreSQL 连接字符串（当使用 postgres 存储时）
• --prompt-dir <DIR>：提示存储目录（当使用文件系统存储时）

与 Claude 集成

要与 Claude Desktop 集成：

1. 打开 Claude Desktop
2. 转到设置 → 开发者 → 编辑配置
3. 添加以下内容到你的配置中：

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

📚 详细文档

API 端点

提示

• GET /prompts：列出所有提示
• GET /prompts/:id：获取特定提示
• POST /prompts：创建新提示
• PUT /prompts/:id：更新现有提示
• DELETE /prompts/:id：删除提示

SSE

• GET /events：实时更新的 Server-Sent Events 端点

🔧 技术细节

开发

项目结构

• src/main.rs：入口点和服务器设置
• src/prompt/：提示模型和逻辑
• src/storage/：存储后端实现
• src/api/：API 端点处理程序
• src/template/：模板处理工具

从源代码构建

cargo build

运行测试

cargo test

Docker 支持

使用 Docker 构建和运行：

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

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

1. 叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📄 许可证

本项目根据 Apache License 2.0 许可，有关详细信息请参阅 LICENSE 文件。

👏 致谢

• 原始 mcp-prompts TypeScript 项目
• Model Context Protocol
• Rust SDK for MCP