关键词

Claude AI提示词管理链式提示流AI工作流自定义提示词

Claude自定义提示词服务器使用说明

这是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为Claude AI等LLM客户端提供强大的自定义提示词管理和工作流自动化能力。通过标准化的JSON-RPC协议与客户端通信，扩展了LLM的应用场景。

主要功能点

  • 智能提示词管理: 支持动态加载、热重载提示词模板，提供高级参数验证和类型检查，以及上下文感知占位符解析。
  • 下一代工作流程引擎: 允许创建和执行多步的“提示词链”，实现复杂的AI推理流程，支持模块化分类组织提示词。
  • 多传输协议支持: 除了MCP标准的Stdio，还支持SSE (Server-Sent Events) 协议。
  • 开发者工具: 提供API接口，方便通过程序化方式管理提示词，例如热重载或更新提示词。
  • 文本引用系统: 智能处理长文本输入，将其存储为可复用的引用，减少每次发送给LLM的数据量。

安装步骤

在开始之前，请确保您已安装Node.js (版本16或更高) 和npm或yarn包管理器，并且拥有Claude Desktop应用（或其他支持MCP协议的客户端）。

  1. 克隆仓库: 打开终端或命令行，克隆项目的GitHub仓库到本地。 
    git clone https://github.com/minipuft/claude-prompts-mcp.git
  2. 进入服务器目录: 进入克隆下来的仓库中的'server'目录。 
    cd claude-prompts-mcp/server
  3. 安装依赖: 使用npm或yarn安装项目所需的依赖。 
    npm install
    或 
    yarn install
  4. 构建项目: 构建TypeScript源代码。 
    npm run build
  5. 启动服务器: 启动MCP服务器。 
    npm start
    服务器默认使用STDIO协议（通常用于Claude Desktop直接启动）或SSE协议（用于API访问）。具体启动协议由服务器配置和启动参数决定。

服务器配置 (MCP客户端)

MCP服务器是为MCP客户端提供服务的。MCP客户端（如Claude Desktop）需要知道如何启动并连接到您的MCP服务器。这通常在客户端的配置文件中完成，例如Claude Desktop的'claude_desktop_config.json'文件。

您需要在客户端的配置中添加一个MCP服务器条目，指定服务器的启动命令 ('command') 和参数 ('args')。以下是一个示例配置及其说明（请根据您的实际文件路径进行修改）：

{
  "mcpServers": {
    "claude-prompts-mcp-server": { // 给您的服务器取一个唯一的名称
      "command": "node", // 启动服务器的命令，通常是node
      "args": [
        "E:\\\\path\\\\to\\\\claude-prompts-mcp\\\\server\\\\dist\\\\index.js", // 指向服务器构建后的入口文件，使用双反斜杠或正斜杠
        "--transport=stdio" // 指定使用stdio传输协议，这是Claude Desktop推荐的
      ],
      "env": {
         "MCP_PROMPTS_CONFIG_PATH": "E:\\\\path\\\\to\\\\claude-prompts-mcp\\\\server\\\\promptsConfig.json", // **重要:** 指定promptsConfig.json的绝对路径，解决路径问题
         "MCP_SERVER_ROOT": "E:\\\\path\\\\to\\\\claude-prompts-mcp\\\\server" // 可选: 如果MCP_PROMPTS_CONFIG_PATH未设置，此变量可帮助服务器找到根目录
      },
      "cwd": "E:\\\\path\\\\to\\\\claude-prompts-mcp\\\\server" // 可选: 设置服务器的工作目录
    }
  }
}

在上述配置中，请将'E:\\path\\to\\claude-prompts-mcp\\server'替换为您实际的项目'server'目录路径。'MCP_PROMPTS_CONFIG_PATH'环境变量是推荐的设置方式，用于明确指定提示词配置文件的位置。

基本使用方法

在您的MCP客户端（如Claude Desktop）中连接到服务器后，您可以通过客户端的界面或命令行调用服务器提供的提示词命令。

  • 列出可用命令: 输入'>>listprompts'或'/listprompts'来查看服务器加载的所有提示词及其用法。
  • 执行简单提示词: 根据'listprompts'显示的格式调用提示词。例如，如果有一个名为'friendly_greeting'的提示词接受一个'name'参数： 
    >>friendly_greeting name="未来开发者"
  • 执行链式提示词: 如果'listprompts'显示某个命令是链式提示词（例如'content_analysis_chain'），您可以像调用普通提示词一样调用它： 
    >>content_analysis_chain text="这是一段需要分析的内容" focus="创新"
    服务器将按照链中定义的步骤依次执行多个提示词。
  • 使用JSON参数: 对于参数较多的提示词，您也可以使用JSON格式提供参数： 
    >>research_prompt {"topic": "AI趋势", "depth": "全面"}

故障排除

如果在Claude Desktop中启动服务器失败或提示词无法工作，请检查以下项：

  • 'claude_desktop_config.json'中的'command'和'args'路径是否正确（使用绝对路径，特别是'dist/index.js'）。
  • 'MCP_PROMPTS_CONFIG_PATH'环境变量是否已正确设置为您的'promptsConfig.json'文件的绝对路径。
  • 检查服务器运行终端是否有错误输出。

更多详细的API接口和高级配置，请参考项目的在线文档。

信息

分类

AI与计算

访问项目