iriver/PromptX

Fork 0

Files

AgustD 551ddae207 更新README文件，简化工作目录配置说明，提升内容清晰度和可读性。

2025-06-13 20:00:06 +08:00

9.1 KiB

Raw Blame History

PromptX · AI应用原生专业能力增强系统

通过MCP协议为AI应用提供专业角色、记忆管理和知识体系，一行命令，让任何 AI 客户端秒变专业选手。

中文 | English | Issues

✨ 一眼看懂 PromptX

PromptX 能做什么？简单来说，它让你的 AI 助手拥有了"大脑"和"记忆"。

🎭 专业角色扮演: 提供覆盖不同领域的专家角色，让 AI 的回答更专业、更深入。
🧠 长期记忆与知识库: AI能够记住关键信息和你的偏好，在持续的对话和工作中提供连贯、个性化的支持。
🔌 轻松集成: 只需一行命令，即可为数十种主流 AI 应用（如 Claude、Cursor）无缝启用这些强大功能。

📸 配置成功后的使用效果

1. 发现并激活专业角色

使用 promptx_hello 发现可用角色，再用 promptx_action 激活，AI即刻变身领域专家。

2. 拥有智能记忆

使用 promptx_remember 保存关键信息，AI将在后续的交流中主动运用这些知识。

🚀 一键启动，30秒完成配置

打开配置文件，将下面的 promptx 配置代码复制进去。这是最简单的 零配置模式，PromptX 会自动为您处理一切。

{
  "mcpServers": {
    "promptx": {
      // 指定使用 npx 运行 promptx 服务
      "command": "npx",
      // '-y' 自动确认, '-f' 强制刷新缓存, 'dpml-prompt@snapshot' 使用最新版, 'mcp-server' 启动服务
      "args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"]
    }
  }
}

🎯 就这么简单！ 保存文件并重启您的AI应用，PromptX 就已成功激活。

🔧 如果您想指定一个特定的文件夹作为 PromptX 的工作区，可以添加 env 环境变量。

{
  "mcpServers": {
    "promptx": {
      "command": "npx",
      "args": ["-y", "-f", "dpml-prompt@snapshot", "mcp-server"],
      "env": {
        // PROMPTX_WORKSPACE: 自定义工作空间路径 (可选，系统会自动识别)
        // Windows: "D:\\path\\to\\your\\project" (注意使用双反斜杠)
        // macOS/Linux: "/Users/username/path/your/project"
        "PROMPTX_WORKSPACE": "/your/custom/workspace/path"
      }
    }
  }
}

⚙️ 工作原理

PromptX 作为您和AI应用之间的"专业能力中间件"，通过标准的 MCP协议进行通信。

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应用，最终呈现给您。

不知道MCP怎么使用？点击查看 MCP幼儿园教程 BiliBili

支持MCP的AI应用

AI应用	状态	配置文件位置	特性
Claude Desktop	✅ 官方支持	Windows: `%APPDATA%\Claude\claude_desktop_config.json` macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`	Anthropic官方客户端，MCP原生支持
Cursor	✅ 支持	通过MCP设置面板配置	智能代码编辑器，开发者友好
Claude Code	✅ 支持	`/home/user/.claude.json` 或者 `~/.claude.json`	Anthropic官方CLI工具，MCP原生支持，命令行AI编程助手
Windsurf	✅ 支持	IDE内MCP配置面板	Codeium推出的AI原生IDE
Cline	✅ 支持	VS Code插件配置	强大的AI编程助手
Augment	✅ 支持	桌面应用配置	AI原生代码编辑器
Trae	✅ 支持	IDE插件配置	AI驱动的代码生成和重构工具
通义灵码	🟡 计划支持	阿里云IDE插件	阿里云推出的AI编程助手
Zed	✅ 支持	配置文件：`~/.config/zed/settings.json`	高性能代码编辑器
Continue	✅ 支持	VS Code插件配置	VS Code AI助手插件
Replit Agent	🟡 实验支持	Replit平台内置	在线编程环境
Jan	🟡 开发中	本地AI客户端	隐私优先的本地AI助手
Ollama WebUI	🟡 社区支持	第三方MCP适配器	本地大模型界面
Open WebUI	🟡 社区支持	插件系统	开源AI界面
百度 Comate	🟡 计划支持	百度IDE插件	百度推出的AI编程助手
腾讯 CodeWhisperer	🟡 计划支持	腾讯云IDE	腾讯云AI编程工具

图例说明：

✅ 官方支持：原生或通过官方插件支持MCP协议。

🟡 实验/社区/计划支持：通过社区插件、实验性功能或已列入开发计划。

更多AI应用正在接入...

🎯 配置完成后，您的AI应用将自动获得6个专业工具：

promptx_init: 🏗️ 系统初始化 - 自动准备工作环境。
promptx_hello: 👋 角色发现 - 浏览所有可用的专家角色。
promptx_action: ⚡ 角色激活 - 一键变身指定领域的专家。
promptx_learn: 📚 知识学习 - 让AI学习特定的知识或技能。
promptx_recall: 🔍 记忆检索 - 从记忆库中查找历史信息。
promptx_remember: 💾 经验保存 - 将重要信息存入长期记忆。

📖 查看完整MCP集成指南

📋 实践案例: Legacy Lands Library

📖 项目概述

项目名称： Legacy Lands Library
项目地址： https://github.com/LegacyLands/legacy-lands-library
项目简介： legacy-lands-library 是一个面向现代 Minecraft 服务端插件开发的开发工具库。它旨在为开发者提供一个跨平台、生产就绪的基础设施。

🏢 组织信息

组织名称： 遗迹之地制作组 (Legacy Lands)
官方网站： https://www.legacylands.cn/
组织简介： 遗迹之地 (Legacy Lands) 是一个专注于构建大型 Minecraft 文明模拟体验的创新团队。参与开源社区，为 Minecraft 服务端插件等领域开发提供优雅、高效且可靠的解决方案。

💡 核心开发者使用心得

"使用 PromptX 的开发体验真的非常不一样。我们团队基于 Claude Code 并结合 PromptX，一位开发者仅三天内就完成了超过一万一千行的高质量 Java 代码。

这套工作流的价值在实际开发中体现得淋漓尽致。PromptX 解决了 AI 使用时的许多痛点，时刻确保代码风格的统一和质量的达标，大大降低了新成员的学习成本。过去那些需要反复沟通、依靠文档传承的最佳实践，现在能够自然而然地融入到每一次代码生成中。"

📚 相关资源

AI集成标准与实践指南： https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md

⭐ Star增长趋势

🤝 贡献与交流

我们欢迎任何形式的贡献和反馈！

📋 贡献流程 - 详细的贡献指南和代码规范
🌿 分支策略 - 分支管理和发布流程
🚀 发布流程 - 版本管理和发布文档

扫码加入技术交流群：

📄 许可证

MIT License - 让AI专业能力触手可及

9.1 KiB Raw Blame History Unescape Escape