What is Mcp Prompt Server

mcp-prompt-server is a server based on the Model Context Protocol (MCP) that provides preset prompt templates tailored to user task requirements, facilitating more efficient execution of various tasks in editors like Cline, Cursor, and Windsurf.

Use cases

Use cases include invoking the code review tool in Cursor or Windsurf with specific code snippets, generating API documentation from Python code, and creating test case generators for different programming scenarios.

How to use

To use mcp-prompt-server, first install the dependencies by running ‘npm install’ in the prompt-server directory. Then, start the server with ‘npm start’. The server will run on standard input/output, allowing connections from MCP clients like Cursor and Windsurf.

Key features

- Provides preset prompt templates for tasks such as code review, API documentation generation, and code refactoring.

• Returns all prompt templates as MCP tools instead of MCP prompts format.
• Supports dynamic parameter replacement for more flexible prompt templates.
• Allows developers to freely add and modify prompt templates.
• Offers a tool API for reloading prompts and querying available prompts.
• Optimized for better integration with editors like Cursor and Windsurf.

Where to use

mcp-prompt-server can be used in software development environments, particularly in code editing and documentation generation tasks, making it suitable for developers and teams working with various programming languages.

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

2. 启动服务器：

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替换为您实际的项目路径。

3. 保存配置并重启编辑器
4. 现在您应该能够在工具面板中看到所有可用的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替换为您实际的项目路径。

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

扩展建议

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