Claude Code Prompt Engineer MCP Server
An advanced Model Context Protocol (MCP) server that intelligently engineers and optimizes prompts for Claude Code, with interactive refinement capabilities and automatic optimization.
Features
🚀 Intelligent Prompt Engineering
- Automatically detects programming language and task type
- Optimizes prompts specifically for Claude Code's capabilities
- Leverages knowledge of Claude Code's tools and workflows
🤖 Interactive Refinement
- Q&A-based prompt clarification system
- Context-aware question generation
- Session-based refinement process
⚡ Automatic Optimization
- Language-specific prompt enhancement
- Task complexity detection
- Claude Code capability awareness
- No external API dependencies - works entirely with built-in capabilities
Installation & Setup
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
# Exit current session and start new one
claude
4. Verify Installation
/mcp
You should see prompt-engineer listed as connected.
Usage with Claude Code
🎯 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"
Available Tools
auto_optimize ⭐ Primary Tool
Automatically detects and optimizes natural language text:
text(required): Your natural language text/requestcontext(optional): Additional project contextinteractive(optional): Force interactive questioning
engineer_prompt
Manual prompt engineering with specific parameters:
prompt(required): The raw user prompt that needs engineeringlanguage(optional): Programming language (auto-detected if not provided)context(optional): Additional project contextinteractive(optional): Enable Q&A refinement process
answer_questions
Used to provide answers during interactive sessions:
sessionId(required): Session ID from interactive modeanswers(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.