Promptopia Mcp

Promptopia MCP

一款功能强大的模型上下文协议（MCP）服务，用于管理、整理和重用提示词模板，并支持变量替换和多消息对话结构。

简介

Promptopia MCP 是一款全面的 MCP 服务，能够通过模型上下文协议帮助 AI 应用高效管理提示词模板。该服务为单内容提示词和复杂的多消息对话模板提供持久化存储，并支持自动检测变量、替换变量，以及与兼容 MCP 的 AI 客户端无缝集成。

Promptopia MCP 使用 TypeScript 构建，专为可扩展性而设计。它通过集中式、可重用的提示词管理系统，改变你使用 AI 提示词的方式，并通过标准化的 MCP 协议直接集成到 AI 工作流中。

为什么使用此服务？

• 集中管理提示词：通过文件系统持久化，在一个安全的位置存储、整理和管理所有提示词模板的版本，避免提示词文件散落各处，并确保不同项目间的一致性。

• 高级多消息支持：创建包含基于角色的消息结构（user/assistant）的复杂对话模板，同时支持文本和图像内容，从而实现复杂的 AI 交互模式。

• 智能变量替换：使用 {{variable}} 语法自动检测变量，并在运行时应用动态值，让提示词能够灵活地在不同场景和用例中重复使用。

• 无缝集成 MCP：原生支持 MCP 协议，因此无需额外配置，你的提示词即可作为一等资源，自动提供给 Claude Desktop、IDE 和其他兼容 MCP 的应用使用。

• 面向未来的架构：在设计时充分考虑了可扩展性，支持提示词链、条件逻辑、版本管理和高级工作流模式，以满足不断演进的 AI 交互需求。

功能

核心提示词管理

• 创建和存储提示词：添加单内容提示词和多消息提示词，并自动检测变量
• 检索和列出提示词：通过 ID 访问单个提示词，或浏览所有可用模板及其元数据
• 更新和删除提示词：修改现有提示词，或通过完整的 CRUD 操作移除过时模板
• 应用变量：将模板变量替换为实际值，以便立即使用

多消息对话支持

• 基于角色的消息：通过明确的 user 和 assistant 消息角色构建对话
• 混合内容类型：支持在同一对话模板中包含文本和图像内容
• 跨消息变量：在对话的多条消息中提取和应用变量
• 格式转换：根据需要在单内容和多消息格式之间无缝转换

MCP 协议集成

• 原生 MCP 提示词：将已存储的提示词作为 MCP 提示词提供，以便在兼容的应用中直接使用
• 基于工具的访问：提供完整的 MCP 工具集，用于执行提示词管理操作
• 标准化通信：完全遵循 MCP 协议规范，确保可靠集成
• 实时变量解析：通过 MCP 协议应用变量，实现动态执行提示词

高级功能

• 自动检测变量：从提示词内容中解析 {{variable}} 模式并智能提取
• 向后兼容：在添加新功能的同时，继续支持现有的单内容提示词
• 文件系统持久化：采用基于 JSON 的可靠存储，并使用有序的目录结构
• 错误处理：提供全面的错误管理，并返回信息明确且符合 MCP 规范的错误响应
• 类型安全：完全使用 TypeScript 实现，并提供健全的类型定义和验证

计划中的功能

• 条件逻辑：为提示词模板添加分支和条件执行功能
• 版本控制：跟踪更改并保留提示词历史记录，支持回滚
• 搜索和标签：通过元数据和全文搜索功能整理提示词
• 导入/导出：在不同环境之间备份和共享提示词集合

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Promptopia：

npx -y @smithery/cli install @lumile/promptopia-mcp --client claude

选项 1：NPX（推荐）

将此配置添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "promptopia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "promptopia-mcp"
      ],
      "env": {
        "PROMPTS_DIR": "<YOUR_PROMPTS_DIR>"
      }
    }
  }
}

选项 2：本地安装

1. 克隆代码仓库
2. 安装依赖项：

npm install

3. 构建服务：

npm run build

4. 将此配置添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "promptopia-mcp": {
      "command": "node",
      "args": [
        "/path/to/promptopia-mcp/build/index.js"
      ],
      "env": {
        "PROMPTS_DIR": "<YOUR_PROMPTS_DIR>"
      }
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可作为包脚本使用：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

贡献

我们非常欢迎大家贡献！请提交 PR，添加新的 MCP 服务或对代码库进行其他改进。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE.md 文件。

---

由 Lumile 倾心打造 ❤️

如有任何问题或反馈，请联系我们。