mcp-prompts-rs

一个基于 Rust 的服务器，用于管理遵循 Model Context Protocol (MCP) 的 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

许可证

本项目 licensed under Apache License 2.0，有关详细信息请参阅 LICENSE 文件。

致谢

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