提示乐园-mcp
项目介绍
技术文档摘要
Promptopia MCP
一个强大的模型上下文协议（MCP）服务器，用于管理和复用带有变量替换和多消息对话结构的提示模板。
简介
Promptopia MCP 是一个全面的 MCP 服务器，它使 AI 应用能够通过模型上下文协议高效地管理提示模板。该服务器提供了对单内容提示和复杂多消息对话模板的持久存储，包括自动变量检测、替换能力和与兼容 MCP 的 AI 客户端无缝集成。
使用 TypeScript 构建并设计为可扩展，Promptopia MCP 改变了您处理 AI 提示的方式，提供了一个集中的、可重复使用的提示管理系统，通过标准化的 MCP 协议直接集成到您的 AI 工作流程中。
为什么使用此服务器？
- 集中式提示管理：在单一安全位置存储、组织和版本化所有提示模板，消除分散的提示文件，并确保项目之间的一致性。
- 高级多消息支持：创建具有基于角色的消息结构（用户/助手）的复杂对话模板，支持文本和图像内容，实现复杂的 AI 交互模式。
- 智能变量替换：使用
{{variable}}语法自动检测变量并在运行时应用动态值，使您的提示在不同上下文和用例中灵活且可复用。 - 无缝 MCP 集成：原生 MCP 协议支持意味着您的提示自动成为 Claude Desktop、IDE 和其他兼容 MCP 应用程序中的第一类资源，无需额外配置。
- 面向未来的架构：考虑到可扩展性而构建，支持提示链、条件逻辑、版本控制和先进的工作流模式，以适应不断发展的 AI 交互需求。
功能
核心提示管理
- 创建和存储提示：添加单内容和多消息提示，自动检测变量
- 检索和列出：通过 ID 访问单个提示或浏览所有可用模板及其元数据
- 更新和删除：修改现有提示或移除过时模板，支持完整的 CRUD 操作
- 变量应用：将模板变量替换为实际值，以便立即使用
多消息对话支持
- 基于角色的消息：使用明确的用户和助手消息角色构建对话
- 混合内容类型：在同一对话模板中支持文本和图像内容
- 跨消息变量：提取并应用对话中多个消息的变量
- 格式转换：根据需要在单内容和多消息格式之间无缝转换
MCP 协议集成
- 原生 MCP 提示：将存储的提示作为 MCP 提示公开，供兼容应用程序直接使用
- 工具访问：完整的 MCP 工具集用于提示管理操作
- 标准化通信：完全符合 MCP 协议规范，确保可靠集成
- 实时变量解析：通过 MCP 协议应用变量，实现动态提示执行
高级能力
- 自动变量检测：从提示内容中解析
{{variable}}模式，进行智能提取 - 向后兼容性：在添加新功能的同时，继续支持现有的单内容提示
- 文件系统持久性：基于 JSON 的可靠存储，具有组织良好的目录结构
- 错误处理：全面的错误管理，提供信息丰富的 MCP 兼容错误响应
- 类型安全性：完整的 TypeScript 实现，具有强大的类型定义和验证
计划功能
- 条件逻辑：在提示模板中添加分支和条件执行
- 版本控制：跟踪更改并维护提示历史记录，具备回滚功能
- 搜索和标签：使用元数据和全文搜索功能组织提示
- 导入/导出：备份和共享不同环境下的提示集合
安装
通过 Smithery 安装
要通过 Smithery 自动安装 Promptopia for Claude Desktop：
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：本地安装
- 克隆仓库
- 安装依赖项：
npm install
- 构建服务器：
npm run build
- 将以下配置添加到您的 Claude Desktop 配置中：
{
"mcpServers": {
"promptopia-mcp": {
"command": "node",
"args": [
"/path/to/promptopia-mcp/build/index.js"
],
"env": {
"PROMPTS_DIR": "<YOUR_PROMPTS_DIR>"
}
}
}
}
调试
由于 MCP 服务器通过标准 I/O 进行通信，调试可能具有挑战性。我们建议使用 MCP Inspector，这是一个包脚本：
npm run inspector
Inspector 将提供一个 URL，您可以在浏览器中访问调试工具。
贡献
非常欢迎贡献！请打开一个新的 PR，包含新的 MCP 服务器或对代码库的任何改进。
许可证
本项目采用 MIT 许可证 - 详情见 LICENSE.md 文件。
<p align="center"> 由 Lumile 制作 ❤️ </p> <p align="center"> 如有任何问题或反馈，请联系我们：<a href="https://www.lumile.com.ar">联系我们</a> </p>