提示工坊

modelscope·@sparesparrow/mcp-prompts

简介

通过简化的SOLID架构，启用提示词的创建、管理和模板化，允许用户按类别组织提示词并在运行时填充模板。

MCP Server 详情

来自 ModelScope 索引

MCP 提示服务器

一个用于管理提示和模板并具备项目编排能力的MCP服务器。是Model Context Protocol生态系统的一部分。

此服务器提供了一种简单的方式来存储、检索和应用AI提示模板，使您更容易在AI应用程序中保持一致的提示模式。

特性

存储和检索提示
创建和使用带有变量的模板
通过标签过滤列出提示
向模板应用变量
多个存储后端（文件系统、PostgreSQL 和 MDC 格式）
易于与Claude及其他AI助手配合使用
项目编排功能
健康检查端点

安装

使用 npx (推荐)

npx -y @sparesparrow/mcp-prompts

全局安装

npm install -g @sparesparrow/mcp-prompts

使用 Docker

docker run -p 3003:3003 -v ~/mcp/data:/app/data sparesparrow/mcp-prompts:latest

验证安装

安装后，您可以按照以下步骤验证服务器是否正常工作：

打开Claude桌面版
在聊天输入框中键入"/"以查看来自服务器的提示是否出现

测试一个简单的工具调用：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "list_prompts",
  arguments: {}
});

配置

服务器可以通过环境变量进行配置：

环境变量	描述	默认值
SERVER_NAME	服务器名称	MCP Prompts Server
SERVER_VERSION	服务器版本	package.json 版本
STORAGE_TYPE	存储类型：'file', 'postgres' 或 'mdc'	file
PROMPTS_DIR	存储提示的目录	~/mcp/data/prompts
BACKUPS_DIR	备份目录	~/mcp/data/backups
PORT	HTTP 服务器端口	3003
LOG_LEVEL	日志级别	info
HTTP_SERVER	启用 HTTP 服务器	false
HOST	HTTP 服务器主机	0.0.0.0

PostgreSQL 设置（如果 STORAGE_TYPE=postgres，则需要）

环境变量	描述	默认值
PG_HOST	PostgreSQL 主机	localhost
PG_PORT	PostgreSQL 端口	5432
PG_DATABASE	PostgreSQL 数据库名	mcp_prompts
PG_USER	PostgreSQL 用户名	postgres
PG_PASSWORD	PostgreSQL 密码
PG_SSL	使用 SSL 连接 PostgreSQL	false
POSTGRES_CONNECTION_STRING	完整的 PostgreSQL 连接字符串（覆盖单独设置）

MDC 设置（如果 STORAGE_TYPE=mdc，则需要）

环境变量	描述	默认值
MDC_RULES_DIR	MDC 规则目录	./.cursor/rules

使用方法

与 Claude 一起使用

在 Claude 3 桌面应用程序中，您可以在 claude_desktop_config.json 中配置 MCP 提示服务器：

{
  "mcpServers": {
    "prompts": {
      "command": "npx",
      "args": [
        "-y",
        "@sparesparrow/mcp-prompts"
      ],
      "env": {
        "STORAGE_TYPE": "file",
        "PROMPTS_DIR": "/path/to/your/prompts/directory",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

可用工具

MCP 提示服务器提供以下工具：

add_prompt: 添加新提示
get_prompt: 通过 ID 获取提示
update_prompt: 更新现有提示
list_prompts: 列出所有提示
delete_prompt: 通过 ID 删除提示
apply_template: 应用变量到提示模板

API 使用示例

列出可用提示

要查看可用的提示：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "list_prompts",
  arguments: {}
});

按标签过滤：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "list_prompts",
  arguments: {
    tags: ["development"]
  }
});

获取特定提示

通过 ID 检索特定提示：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "get_prompt",
  arguments: {
    id: "development-workflow"
  }
});

使用模板提示

应用变量到模板提示：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "apply_template",
  arguments: {
    id: "development-system-prompt",
    variables: {
      "project_type": "web frontend",
      "language": "JavaScript/React",
      "project_name": "TaskManager",
      "project_goal": "create a task management application with drag-and-drop functionality",
      "technical_context": "Using React 18, TypeScript, and Material UI"
    }
  }
});

管理提示

添加新提示

添加新提示：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "add_prompt",
  arguments: {
    name: "Bug Report Template",
    description: "Template for submitting bug reports",
    content: "## Bug Report\n\n### Description\n{{description}}\n\n### Steps to Reproduce\n{{steps}}\n\n### Expected Behavior\n{{expected}}\n\n### Actual Behavior\n{{actual}}\n\n### Environment\n{{environment}}",
    isTemplate: true,
    variables: ["description", "steps", "expected", "actual", "environment"],
    tags: ["bug", "template", "documentation"]
  }
});

编辑现有提示

编辑现有提示：

use_mcp_tool({
  server_name: "prompt-manager",
  tool_name: "edit_prompt",
  arguments: {
    id: "development-workflow",
    content: "Updated workflow content here...",
    tags: ["development", "workflow", "python", "updated"]
  }
});

在您的工作流中使用提示

开发工作流示例

当开始开发一个新功能时：

请求开发系统提示模板
用项目详细信息填充模板
使用生成的系统提示来指导 Claude 的帮助

代码审查示例

当审查代码时：

请求代码审查模板
提供待审查的代码
Claude 将提供结构化的审查

提示格式

提示具有以下结构：

{
  "id": "unique-id",
  "name": "Prompt Name",
  "description": "Optional description",
  "content": "The prompt content with {{variables}}",
  "tags": ["tag1", "tag2"],
  "isTemplate": true,
  "variables": ["variable1", "variable2"],
  "metadata": {
    "author": "Your Name",
    "version": "1.0.0"
  }
}

多格式提示支持

MCP 提示服务器包括一个强大的 MutablePrompt 接口，允许提示在多种格式之间转换：

JSON 格式: 服务器使用的标准内部格式
MDC 格式: 游标规则 Markdown 格式（.mdc 文件）
PGAI 格式: 支持嵌入的 PostgreSQL AI 格式
模板格式: 带有变量占位符的动态格式

格式之间的转换

MutablePrompt 接口提供了在这些格式之间转换提示的方法：

// Create a mutable prompt
const factory = new MutablePromptFactoryImpl();
const prompt = factory.create({
  name: "API Design Guide",
  descrip…

简介