mcp-prompt-server

MCP.Pizza Chef: gdli6177

The mcp-prompt-server is an MCP server that delivers preset prompt templates tailored to user task requirements. It exposes these prompts as MCP tools, enabling seamless integration with editors like Cursor and Windsurf. The server supports dynamic parameter replacement, allowing flexible prompt customization, and offers APIs for reloading and querying available prompts. It is optimized for developer workflows such as code review, API documentation, and code refactoring, enhancing productivity in AI-assisted coding environments.

Use This MCP server To

Provide preset prompt templates for code review tasks Generate API documentation using dynamic prompt templates Facilitate code refactoring with customizable prompts Serve prompt tools to MCP clients like Cursor and Windsurf Allow developers to add and modify prompt templates easily Enable dynamic parameter replacement in prompt templates Reload prompt templates via server API without downtime Query available prompt templates programmatically

README

MCP Prompt Server

English Version

这是一个基于Model Context Protocol (MCP)的服务器,用于根据用户任务需求提供预设的prompt模板,帮助Cline/Cursor/Windsurf...更高效地执行各种任务。服务器将预设的prompt作为工具(tools)返回,以便在Cursor和Windsurf等编辑器中更好地使用。

功能特点

  • 提供预设的prompt模板,可用于代码审查、API文档生成、代码重构等任务
  • 将所有prompt模板作为MCP工具(tools)提供,而非MCP prompts格式
  • 支持动态参数替换,使prompt模板更加灵活
  • 允许开发者自由添加和修改prompt模板
  • 提供工具API,可重新加载prompt和查询可用prompt
  • 专为Cursor和Windsurf等编辑器优化,提供更好的集成体验

目录结构

prompt-server/
├── package.json         # 项目依赖和脚本
├── src/                 # 源代码目录
│   ├── index.js         # 服务器入口文件
│   └── prompts/         # 预设prompt模板目录
│       ├── code_review.yaml
│       ├── api_documentation.yaml
│       ├── code_refactoring.yaml
│       ├── test_case_generator.yaml
│       └── project_architecture.yaml
└── README.md            # 项目说明文档

安装和使用

  1. 安装依赖:
cd prompt-server
npm install
  1. 启动服务器:
npm start

服务器将在标准输入/输出上运行,可以被Cursor、Windsurf或其他MCP客户端连接。

添加新的Prompt模板

您可以通过在src/prompts目录中添加新的YAML或JSON文件来创建新的prompt模板。每个模板文件应包含以下内容:

name: prompt_name                # 唯一标识符,用于调用此prompt
description: prompt description  # 对prompt功能的描述
arguments:                       # 参数列表(可选)
  - name: arg_name               # 参数名称
    description: arg description # 参数描述
    required: true/false         # 是否必需
messages:                        # prompt消息列表
  - role: user/assistant         # 消息角色
    content:
      type: text                 # 内容类型
      text: |                    # 文本内容,可包含参数占位符 {{arg_name}}
        Your prompt text here...

添加新文件后,服务器会在下次启动时自动加载,或者您可以使用reload_prompts工具重新加载所有prompt。

使用示例

在Cursor或Windsurf中调用代码审查工具

{
  "name": "code_review",
  "arguments": {
    "language": "javascript",
    "code": "function add(a, b) { return a + b; }"
  }
}

在Cursor或Windsurf中调用API文档生成工具

{
  "name": "api_documentation",
  "arguments": {
    "language": "python",
    "code": "def process_data(data, options=None):\n    # 处理数据\n    return result",
    "format": "markdown"
  }
}

工具API

服务器提供以下管理工具:

  • reload_prompts: 重新加载所有预设的prompts
  • get_prompt_names: 获取所有可用的prompt名称

此外,所有在src/prompts目录中定义的prompt模板都会作为工具提供给客户端。

与编辑器集成

Cursor

在Cursor中,您需要编辑MCP配置文件:

  1. 找到或创建Cursor的MCP配置文件(通常位于~/.cursor/目录)
  2. 添加以下内容:
{
  "servers": [
    {
      "name": "Prompt Server",
      "command": ["node", "/path/to/prompt-server/src/index.js"],
      "transport": "stdio",
      "initialization_options": {}
    }
  ]
}

请确保将/path/to/prompt-server替换为您实际的项目路径。

  1. 保存配置并重启编辑器
  2. 现在您应该能够在工具面板中看到所有可用的prompt工具

Windsurf

在Windsurf中,通过以下方式访问MCP配置:

  1. 导航至 Windsurf - 设置 > 高级设置,或
  2. 使用命令面板 > 打开Windsurf设置页面
  3. 滚动到Cascade部分,您会看到添加新服务器的选项
  4. 点击"添加服务器"按钮,然后选择"添加自定义服务器+"
  5. 或者,您可以直接编辑~/.codeium/windsurf/mcp_config.json文件,添加以下内容:
{
  "mcpServers": {
    "prompt-server": {
      "command": "node",
      "args": [
        "/path/to/prompt-server/src/index.js"
      ],
      "transport": "stdio"
    }
  }
}

请确保将/path/to/prompt-server替换为您实际的项目路径。

  1. 添加服务器后,点击刷新按钮
  2. 现在您应该能够在工具面板中看到所有可用的prompt工具

扩展建议

  1. 添加更多专业领域的prompt模板
  2. 实现prompt版本控制
  3. 添加prompt分类和标签
  4. 实现prompt使用统计和分析
  5. 添加用户反馈机制

mcp-prompt-server FAQ

How do I add new prompt templates to the mcp-prompt-server?
Add new YAML or JSON files to the src/prompts directory and reload the server to apply changes.
Can I customize prompt templates dynamically?
Yes, the server supports dynamic parameter replacement within prompt templates for flexible usage.
How does the server integrate with editors like Cursor and Windsurf?
It exposes prompt templates as MCP tools, which these editors can consume directly for enhanced workflows.
Is it possible to reload prompts without restarting the server?
Yes, the server provides an API to reload prompt templates dynamically.
What formats are supported for prompt templates?
The server supports YAML and JSON formats for defining prompt templates.
Can developers modify existing prompt templates?
Yes, developers can freely add, edit, or remove prompt templates in the prompts directory.
How does the server handle multiple prompt templates?
It manages and exposes all prompt templates as individual MCP tools accessible to clients.
What kind of tasks are the preset prompts designed for?
Tasks include code review, API documentation generation, code refactoring, test case generation, and project architecture analysis.