PromptX 快速上手指南

PromptX 是一个领先的 AI 智能体上下文平台，基于 MCP 协议，旨在通过自然对话将 Claude、Cursor 等 AI 应用瞬间转化为行业专家。它无需复杂的指令语法，只需像与人交谈一样表达需求，即可激活专业的 AI 角色、工具开发和认知记忆系统。

环境准备

在开始之前，请确保满足以下系统要求：

• 操作系统：
  • macOS (Apple Silicon 或 Intel)
  • Windows (需额外安装 Git for Windows 以支持 AgentX 功能)
  • Linux (支持 Docker 部署)
• 前置依赖：
  • Node.js：如果你选择开发者模式（Direct Run），需要安装 Node.js 环境。
  • AI 客户端：已安装支持 MCP 协议的 AI 编辑器或应用（如 Claude Desktop, Cursor, Trae 等）。
  • Docker (可选)：如果你选择容器化部署。

安装步骤

推荐普通用户使用 PromptX 桌面客户端，它提供可视化界面且零配置启动。开发者也可选择 npm 或 Docker 方式。

方法一：下载桌面客户端（推荐）

1. 下载安装包： 根据你的操作系统下载对应的安装包：

   • macOS (Apple Silicon): 下载 .dmg
   • macOS (Intel): 下载 .dmg
   • Windows: 下载 .exe
   • 其他平台（Linux/便携版）: 查看全部版本

2. 安装并运行： 安装完成后启动 PromptX 客户端。它将自动在本地运行 MCP 服务器（默认端口 5203）。

方法二：使用 npm 直接运行（开发者）

如果你已有 Node.js 环境，可以直接通过 npx 运行：

npx -y @promptx/mcp-server

方法三：使用 Docker 部署（生产环境）

适用于服务器或生产环境部署：

docker run -d -p 5203:5203 -v ~/.promptx:/root/.promptx deepracticexs/promptx:latest

基本使用

安装完成后，你需要将 PromptX 连接到你的 AI 应用中，然后通过自然语言召唤专家。

1. 配置 AI 应用

在你的 AI 工具（如 Claude Desktop, Cursor, Trae）的配置文件中添加 MCP 服务器配置。

通用配置 (Claude/Cursor):

{
  "mcpServers": {
    "promptx": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:5203/mcp"
    }
  }
}

Trae 专用配置:

{
  "mcpServers": {
    "promptx": {
      "url": "http://127.0.0.1:5203/mcp"
    }
  }
}

注意：如果你使用的是桌面客户端，请确保客户端正在运行；如果是 npm 或 Docker 方式，请确保服务进程已在后台启动。

2. 召唤专家

配置完成后，重启你的 AI 应用，直接在对话框中使用自然语言交互。

步骤 1：查看可用专家 输入以下命令查看内置的专家角色列表：

Show me what experts are available

AI 将立即列出包括产品经理、架构师、作家等在内的 23+ 个可用角色。

步骤 2：激活特定专家 直接表达你的需求，例如：

I need a product manager expert

AI 将瞬间转变为具备完整知识体系和方法论的专业产品经理。

步骤 3：开始专业对话 现在你可以进行深度专业咨询：

Help me redesign the product page

AI 将以专业产品经理的身份，提供深入的产品策略建议。

3. 内置专家角色示例

PromptX 内置了多个精心设计的角色，你可以随时通过一句话激活：

• 女娲 (Nuwa)：AI 角色创造者。说一句“创建一个懂代码又懂产品的专家”，即刻生成新角色。
• 鲁班 (Luban)：工具集成大师。能在 3 分钟内帮你集成任何 API。
• 姜山 (Sean)：产品决策与初创战略专家。
• 文章写手 (Writer)：创作不像 AI 生成的专业内容。
• 大禹 (Dayu)：负责角色迁移与组织管理。

只需对 AI 说："Activate Nuwa" 或 "I want to talk to Sean"，即可切换身份。