๐ Claude Code Prompt Engineer MCP Server
An advanced Model Context Protocol (MCP) server that intelligently engineers and optimizes prompts for Claude Code. It comes with interactive refinement capabilities and automatic optimization, enhancing the efficiency and quality of prompt usage.
โจ Features
๐ Intelligent Prompt Engineering
- Automatically detects the programming language and task type.
- Optimizes prompts according to Claude Code's capabilities.
- Utilizes knowledge of Claude Code's tools and workflows.
๐ค Interactive Refinement
- Features a Q&A-based prompt clarification system.
- Generates context-aware questions.
- Implements a session-based refinement process.
โก Automatic Optimization
- Enhances prompts specific to the language.
- Detects task complexity.
- Is aware of Claude Code's capabilities.
- No external API dependencies - operates entirely with built-in capabilities.
๐ฆ Installation
1. Install Dependencies
npm install
2. Configure Claude Code
Create or update your .mcp.json configuration file:
{
"mcpServers": {
"prompt-engineer": {
"command": "node",
"args": ["/absolute/path/to/cc_peng_mcp/index.ts"],
"env": {}
}
}
}
3. Restart Claude Code
claude
4. Verify Installation
/mcp
You should see prompt-engineer listed as connected.
๐ป Usage Examples
๐ฏ Auto-Optimization (Primary Usage)
Simply use the tools directly - no setup required:
Use the auto_optimize tool to analyze: "fix my React app performance issues"
Interactive Mode for Complex Requests
Use the engineer_prompt tool with interactive=true for: "create a new authentication system"
Direct Prompt Engineering
Use the engineer_prompt tool with prompt="optimize my database queries" and language="python"
๐ Documentation
Available Tools
auto_optimize โญ Primary Tool
Automatically detects and optimizes natural language text:
text (required): Your natural language text/request
context (optional): Additional project context
interactive (optional): Force interactive questioning
engineer_prompt
Manual prompt engineering with specific parameters:
prompt (required): The raw user prompt that needs engineering
language (optional): Programming language (auto-detected if not provided)
context (optional): Additional project context
interactive (optional): Enable Q&A refinement process
answer_questions
Used to provide answers during interactive sessions:
sessionId (required): Session ID from interactive mode
answers (required): Array of answers to the questions
How It Works
1. Natural Language Detection
The system automatically identifies when your text is natural language that needs optimization by detecting:
- Request patterns: "help me", "can you", "i need", "i want"
- Problem descriptions: "issue", "bug", "not working", "broken"
- Task indicators: "create", "build", "fix", "optimize"
- Questions: "how do", "what is", "why is"
- Conversational markers: "i'm", "i think", "not sure"
2. Built-in Intelligence
- No API calls required - uses pattern matching and rule-based optimization
- Language detection via regex patterns for 10+ programming languages
- Task type detection (debug, test, refactor, explain, architecture)
- Complexity analysis based on text length and technical indicators
3. Claude Code Optimization
Prompts are optimized knowing Claude Code's capabilities:
- File system operations (Read, Write, Edit)
- Code search (Grep, Glob patterns)
- Git operations and workflow management
- Todo list management for complex tasks
- Browser automation via Playwright MCP
- GitHub integration
4. Interactive Refinement
When needed, the system:
- Generates clarifying questions based on your prompt
- Creates a session to track the conversation
- Refines the prompt based on your answers
- Delivers a highly optimized final prompt
Example Workflows
๐ฏ Auto-Optimization Example
Input:
"my website is slow and users are complaining"
Auto-Optimized Output:
**Task:** Debug and fix the following issue:
my website is slow and users are complaining
**Requirements:**
- Use file search tools (Grep/Glob) to locate relevant code
- Read and analyze the problematic files
- Identify the root cause and implement a fix
- Test the solution if possible
**Ready to proceed with this task?**
๐ค Interactive Mode Example
Input: "make my app better"
Questions Generated:
- What specific aspect needs improvement (performance, readability, maintainability)?
- What technology stack or programming language are you using?
- Are there any constraints or requirements I should know about?
After Answers: Creates detailed, structured prompt with your specific requirements.
Benefits
โ
No Setup Required: Works immediately after MCP configuration
โ
No API Keys: Uses only built-in Claude Code capabilities
โ
Context Aware: Understands your project and requirements
โ
Interactive: Asks clarifying questions when needed
โ
Systematic: Structures complex requests properly
โ
Fast: No external API calls for instant optimization
Requirements
- Node.js 16+
- TypeScript support (tsx recommended)
- Claude Code CLI
- No external API keys required
Technical Details
Supported Languages
- JavaScript/Node.js, TypeScript, Python, Java, C++, Rust, Go, PHP, Ruby, C#/.NET
Task Types
- Debug: Bug fixing and error resolution
- Test: Unit testing and test creation
- Refactor: Code improvement and restructuring
- Explain: Code explanation and documentation
- Architecture: System design and patterns
- Code: General coding tasks (default)
Architecture
- Pure pattern matching - no machine learning models
- Rule-based optimization - deterministic and fast
- Session management - for interactive conversations
- Built-in language detection - regex-based patterns
๐ License
MIT License - feel free to modify and distribute.
๐ Installation Guide
See INSTALL.md for detailed installation instructions, troubleshooting, and advanced configuration options.