mcp-prompts-rs

一个基于 Rust 的服务器，用于使用模型上下文协议 (MCP) 管理 AI 提示。

概述

mcp-prompts-rs 是一个提示管理服务器的 Rust 实现，它遵循模型上下文协议 (MCP)，这是一个用于将 AI 应用程序连接到数据源和工具的开放标准。本项目是原始 mcp-prompts TypeScript 实现的 Rust 重写版本。

该服务器提供存储、检索和管理 AI 提示的功能，支持模板变量、分类和多种存储后端。

特性

• 提示管理: 创建、检索、更新和删除带有分类的提示
• 模板支持: 创建带有变量的提示，用于运行时自定义
• 存储后端: 支持文件系统和 PostgreSQL 存储选项
• API: 具有服务器发送事件 (SSE) 的 RESTful 端点，用于实时更新
• MCP 集成: 实现模型上下文协议，以便与 Claude 等 AI 助手无缝集成
• 项目编排: 使用模板自动化软件项目创建的工具
• 部署: 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>: 提示存储目录（使用 filesystem 存储时）

与 Claude 集成

要与 Claude Desktop 集成：

1. 打开 Claude Desktop
2. 转到 Settings → Developer → Edit Config
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: 用于实时更新的服务器发送事件端点

开发

项目结构

• 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. Fork 存储库
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 项目
• 模型上下文协议
• MCP 的 Rust SDK