PromptX MCP 快速上手

启动服务器

本地模式（推荐）

  1. npx -f -y dpml-prompt@snapshot mcp-server

HTTP 模式（远程访问）

  1. npx -f -y dpml-prompt@snapshot mcp-server --transport http --port 3000

检查服务器状态：

  1. curl http://localhost:3000/health

客户端配置

Claude Desktop（仅本地模式）

配置文件位置：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  1. {
  2.   "mcpServers": {
  3.     "promptx": {
  4.       "command": "npx",
  5.       "args": ["-f", "-y", "dpml-prompt@snapshot", "mcp-server"]
  6.     }
  7.   }
  8. }

VS Code

创建 .vscode/mcp.json：

本地模式：

  1. {
  2.   "servers": {
  3.     "promptx": {
  4.       "command": "npx",
  5.       "args": ["-f", "-y", "dpml-prompt@snapshot", "mcp-server"]
  6.     }
  7.   }
  8. }

HTTP 模式：

  1. {
  2.   "servers": {
  3.     "promptx": {
  4.       "type": "http",
  5.       "url": "http://localhost:3000/mcp"
  6.     }
  7.   }
  8. }

Cursor

本地模式：

  1. {
  2.   "mcpServers": {
  3.     "promptx": {
  4.       "command": "npx",
  5.       "args": ["-f", "-y", "dpml-prompt@snapshot", "mcp-server"]
  6.     }
  7.   }
  8. }

HTTP 模式：

  1. {
  2.   "mcpServers": {
  3.     "promptx": {
  4.       "url": "http://localhost:3000/mcp"
  5.     }
  6.   }
  7. }

LibreChat

编辑 librechat.yaml：

本地模式：

  1. mcpServers:
  2.   promptx:
  3.     command: npx
  4.     args:
  5.       - -f
  6.       - -y
  7.       - dpml-prompt@snapshot
  8.       - mcp-server

HTTP 模式：

  1. mcpServers:
  2.   promptx:
  3.     type: streamable-http
  4.     url: http://localhost:3000/mcp

测试工具

重启客户端后，尝试使用以下工具：

  • promptx_hello - 查看可用角色
  • promptx_action - 激活角色（需要参数：role）
  • promptx_learn - 学习资源（需要参数：resource）
  • promptx_recall - 查看记忆
  • promptx_remember - 保存记忆（需要参数：content）

故障排除

服务器启动失败：

  • 检查 Node.js 版本：node --version（需要 >= 14）
  • 确认网络连接正常（npx 需要下载包）

客户端连接失败：

  • 检查配置文件 JSON/YAML 语法
  • 重启客户端应用
  • 确认 npx 可以运行：npx -f -y dpml-prompt@snapshot --help

HTTP 模式报错：

  • 确认服务器正在运行
  • 检查防火墙设置
  • 使用 curl 测试连接