---

✨ Understanding PromptX at a Glance

What can PromptX do? In simple terms, it gives your AI assistant a "brain" and "memory," and turns you into a creator of AI capabilities.

• 🎭 Professional Role Play: Provides expert roles across different fields, making AI responses more professional and in-depth.
• 🧠 Long-term Memory and Knowledge Base: The AI can remember key information and your preferences, providing coherent and personalized support in ongoing conversations and tasks.
• ✨ AI Role Creation Workshop: Turn your ideas into a professional AI assistant within 2 minutes, transforming from a user to a creator.
• 🔌 Easy Integration: Enable these powerful features for dozens of mainstream AI applications (such as Claude, Cursor) with just one command.

📸 Usage Effects After Successful Configuration

1. Discover and Activate Professional Roles

Use promptx_hello to discover available roles, then activate them with promptx_action, and the AI will instantly become an expert in the field.

2. Possess Intelligent Memory

Use promptx_remember to save key information, and the AI will proactively use this knowledge in subsequent interactions.

---

⚠️ Project Status Explanation

PromptX is currently in the initial development stage. We are actively working on improving features and fixing issues. Before reaching a stable release, you may encounter some usage problems or instability.

We sincerely request your understanding and support! 🙏

📞 Encountering Issues? Get Help!

If you encounter any problems during use, please contact us through the following methods:

• 🐛 Submit an Issue: GitHub Issues - Provide a detailed description of the issue, and we will respond as soon as possible.
• 💬 Direct Contact: Add the developer's WeChat deepracticex for immediate assistance.
• 📧 Email Contact: Send an email to sean@deepracticex.com for technical support.
• 📱 Technical Discussion Group: Scan the QR code below to join our technical discussion group.

Your feedback is very valuable to us and helps us improve the product quality quickly! ✨

---

🚀 One-Click Start, Configuration in 30 Seconds

Open the configuration file and copy the following promptx configuration code into it. This is the simplest zero-configuration mode, and PromptX will handle everything for you automatically.

json
{
"mcpServers": {
"promptx": {
"command": "npx",
"args": [
"-y",
"-f",
"--registry",
"https://registry.npmjs.org",
"dpml-prompt@beta",
"mcp-server"
]
}
}
}

Configuration Parameter Explanation:

• command: Specifies using npx to run the promptx service.
• args: List of startup parameter configurations
  • -y: Automatic confirmation
  • -f: Force cache refresh
  • --registry: Specifies the registry source
  • https://registry.npmjs.org: Uses the official registry
  • dpml-prompt@beta: Uses the stable beta version
  • mcp-server: Starts the service**🎯 That's it!** Save the file and restart your AI application, and PromptX will be successfully activated.

💡 Tip: The configuration specifically specifies the official registry registry.npmjs.org to avoid installation issues caused by using unofficial mirrors. If you find the installation is very slow, it is recommended to use a proxy tool to speed up rather than switch to other mirror sources.

📖 Complete Installation Configuration Guide - Contains detailed configuration methods and troubleshooting for various clients

Not sure what MCP is? Click to view MCP Kindergarten Tutorial on BiliBili

Currently, all AI clients that support the MCP protocol can use PromptX. This mainly includes: Claude Desktop, Cursor, Windsurf, Cline, Zed, Continue, and more mainstream AI programming tools, as well as applications that are in the process of being integrated.

---

⚙️ How It Works

PromptX acts as a "professional capability middleware" between you and the AI application, communicating through the standard MCP protocol.

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

When you call the promptx_... series of tools, the AI application sends the request to PromptX via the MCP protocol. The PromptX engine then loads the corresponding professional roles, retrieves relevant memories, and returns a professionally enhanced result back to the AI application, which is ultimately presented to you.

---

🎯 After configuration, your AI application will automatically gain 6 professional tools:

• promptx_init: 🏗️ System Initialization - Automatically prepares the working environment.
• promptx_hello: 👋 Role Discovery - Browse all available expert roles.
• promptx_action: ⚡ Role Activation - Instantly transform into an expert in a specified field. (Includes Nüwa🎨 Role Creation Advisor)
• promptx_learn: 📚 Knowledge Learning - Let the AI learn specific knowledge or skills.
• promptx_recall: 🔍 Memory Retrieval - Search for historical information from the memory bank.
• promptx_remember: 💾 Experience Saving - Store important information into long-term memory.

📖 View Complete MCP Integration Guide

---

🎨 Nüwa Creation Workshop - Making Everyone an AI Role Designer

💫 From Idea to Reality in Just 2 Minutes

Have you ever thought about what if you could customize a professional AI assistant for a specific work scenario? Nüwa makes this idea a reality.

"Every idea deserves its own dedicated AI assistant; technical barriers should not limit the flight of creativity."

🎯 Core Value Transformation

• 🚀 Zero-Threshold Creation: No need to learn complex technologies, just describe your needs in natural language.
• ⚡ Ultra-Fast Delivery: From concept to usable role in just 2 minutes.
• 🎭 Professional Quality: Automatically generates professional AI roles that meet DPML standards.
• 🔄 Plug-and-Play: Ready to activate and use immediately after creation.
• 💝 Sense of Control: Transition from user to creator with elegance.

✨ Use Case Examples

🎯 User Need	⚡ Nüwa Generation	🚀 Immediately Usable
👩‍💼 "I need an AI assistant who understands Xiaohongshu marketing"	Xiaohongshu Marketing Expert Role	Activate Xiaohongshu Marketing Expert
👨‍💻 "I want a Python asynchronous programming expert"	Python Asynchronous Programming Tutor Role	Activate Python Asynchronous Programming Tutor
🎨 "Give me a UI/UX design consultant"	UI/UX Design Expert Role	Activate UI/UX Design Expert
📊 "Need a data analyst assistant"	Data Analysis Expert Role	Activate Data Analysis Expert

bash

1️⃣ Activate Nuwa's Role Creation Advisor

"I want Nuwa to help me create a role"

2️⃣ Describe your needs (in natural language)

"I need a [field] professional assistant, mainly for [specific scenario]"

3️⃣ Wait 2 minutes while Nuwa generates the professional role for you

Nuwa will create the role file, register it to the system, and complete quality checks

4️⃣ Immediately activate and use your custom AI assistant

"Activate the role just created"

🌟 Nuwa's Design Philosophy

• 🎯 Boundless Creation: Empowering anyone with an idea to create an AI assistant, breaking down technical barriers.
• ⚡ Instant Gratification: Meeting the digital age's demand for immediacy.
• 🧠 Growth Guidance: Not just about using tools, but also guiding users to understand the boundaries of AI capabilities.
• 🌱 Ecosystem Co-creation: Every role created by a user can become a source of inspiration for others.

---

📋 Case Study: Legacy Lands Library

📖 Project Overview

Project Name: Legacy Lands Library
Project URL: https://github.com/LegacyLands/legacy-lands-library
Project Description: legacy-lands-library is a development toolkit aimed at modern Minecraft server plugin development. It provides developers with a cross-platform, production-ready infrastructure.

🏢 Organization Information

Organization Name: Legacy Lands Production Team (Legacy Lands)
Official Website: https://www.legacylands.cn/
Organization Description: Legacy Lands is an innovative team focused on building large-scale Minecraft civilization simulation experiences. We participate in the open-source community, providing elegant, efficient, and reliable solutions for Minecraft server plugins and other areas.

💡 Core Developer Insights

"The development experience with PromptX is truly unique. Our team, based on Claude Code and combined with PromptX, one developer completed over 11,000 lines of high-quality Java code in just three days.

The value of this workflow is evident in real-world development. PromptX addresses many pain points in AI usage, ensuring consistent code style and quality, significantly reducing the learning curve for new members. Best practices that used to require repeated communication and documentation are now naturally integrated into every code generation."

📚 Related Resources

• AI Integration Standards and Practice Guide: https://github.com/LegacyLands/legacy-lands-library/blob/main/AI_CODE_STANDARDS_ZHCN.md

---

⭐ Star Growth Trend

---

🤝 Contributions and Communication

We welcome all forms of contributions and feedback!

• 🌿 Branching Strategy - Branch management and release process
• 🚀 Release Process - Version management and release documentation

Scan to join the technical discussion group:

---

📄 License

MIT License - Making professional AI capabilities accessible