PromptX · AI应用原生专业能力增强系统
通过MCP协议为AI应用提供专业角色、记忆管理和知识体系，一行命令，让任何 AI 客户端秒变专业选手。
#### **2. 拥有智能记忆**
*使用 `promptx_remember` 保存关键信息，AI将在后续的交流中主动运用这些知识。*
---
## ⚠️ **项目状态说明**
PromptX 目前处于 **初始开发阶段**，我们正在积极完善功能和修复问题。在达到正式稳定版本之前，您可能会遇到一些使用上的问题或不稳定情况。
**我们诚恳地请求您的理解和支持！** 🙏
### 📞 **遇到问题？获取帮助！**
如果您在使用过程中遇到任何问题，请通过以下方式联系我们：
- 🐛 **提交 Issue**: [GitHub Issues](https://github.com/Deepractice/PromptX/issues) - 详细描述问题，我们会尽快回复
- 💬 **直接联系**: 添加开发者微信 `deepracticex` 获取即时帮助
- 📧 **邮件联系**: 发送邮件至 `sean@deepracticex.com` 获取技术支持
- 📱 **技术交流群**: 扫描下方二维码加入我们的技术交流群
您的反馈对我们非常宝贵，帮助我们快速改进产品质量！ ✨
---
## 🚀 **一键启动，30秒完成配置**
打开配置文件，将下面的 `promptx` 配置代码复制进去。这是最简单的 **零配置模式**，PromptX 会自动为您处理一切。
```json
{
"mcpServers": {
"promptx": {
// 指定使用 npx 运行 promptx 服务
"command": "npx",
// 启动参数配置
"args": [
"-y", // 自动确认
"-f", // 强制刷新缓存
"--registry", // 指定镜像源
"https://registry.npmjs.org", // 使用官方镜像
"dpml-prompt@beta", // 使用稳定测试版
"mcp-server" // 启动服务
]
}
}
}
```
**🎯 就这么简单！** 保存文件并重启您的AI应用，PromptX 就已成功激活。
> **💡 提示：** 配置中特意指定了官方镜像源 `registry.npmjs.org`，这可以避免因使用非官方镜像导致的安装问题。如果您发现安装很慢，建议使用代理工具加速，而不是切换到其他镜像源。
### 🌐 **高级配置：HTTP 模式支持**
除了上述本地模式外，PromptX 还支持 **HTTP 模式**，适用于远程部署或特殊网络环境：
```bash
# 启动 HTTP 模式服务器
npx -f -y dpml-prompt@beta mcp-server --transport http --port 3000
```
然后在客户端配置中使用：
```json
{
"mcpServers": {
"promptx": {
"url": "http://localhost:3000/mcp"
}
}
}
```
📖 **[完整安装配置指南](https://github.com/Deepractice/PromptX/wiki/PromptX-MCP-Install)** - 包含各种客户端的详细配置方法和故障排除
### 不知道MCP是怎么？ [点击查看 MCP幼儿园教程 BiliBili](https://www.bilibili.com/video/BV1HFd6YhErb)
目前所有支持 MCP 协议的 AI 客户端都可以使用 PromptX。主要包括：**Claude Desktop**、**Cursor**、**Windsurf**、**Cline**、**Zed**、**Continue** 等主流 AI 编程工具，以及更多正在接入中的应用。
---
### ⚙️ **工作原理**
PromptX 作为您和AI应用之间的"专业能力中间件"，通过标准的 [MCP协议](https://github.com/metacontroller/mcp) 进行通信。
```mermaid
graph TD
subgraph "Your AI App (Claude,Cursor,etc.)"
A[👨💻 User Interaction]
end
subgraph "PromptX MCP Server"
C{PromptX Engine}
D[🎭 Role Library]
E[🧠 Memory & Knowledge]
end
A -- "Calls 'promptx_...' tools" --> B(MCP Protocol)
B --> C
C -- "Accesses" --> D
C -- "Accesses" --> E
subgraph "Enhanced Response"
F[✨ Professional Output]
end
C --> F
```
当您调用 `promptx_...` 系列工具时，AI应用会将请求通过MCP协议发送给 PromptX。PromptX 引擎会加载相应的专业角色、检索相关记忆，然后返回一个经过专业能力增强的结果给AI应用，最终呈现给您。
---
**🎯 配置完成后，您的AI应用将自动获得6个专业工具：**
- `promptx_init`: 🏗️ **系统初始化** - 自动准备工作环境。
- `promptx_hello`: 👋 **角色发现** - 浏览所有可用的专家角色。
- `promptx_action`: ⚡ **角色激活** - 一键变身指定领域的专家。
- `promptx_learn`: 📚 **知识学习** - 让AI学习特定的知识或技能。
- `promptx_recall`: 🔍 **记忆检索** - 从记忆库中查找历史信息。
- `promptx_remember`: 💾 **经验保存** - 将重要信息存入长期记忆。
📖 **[查看完整MCP集成指南](docs/mcp-integration-guide.md)**
---
## 📋 **实践案例: Legacy Lands Library**
---
## 📄 **许可证**
[MIT License](LICENSE) - 让AI专业能力触手可及