MCP Prompts Rs

🚀 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