Claude Code Prompt Engineer

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

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/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

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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Tools

Intelligently engineers and optimizes prompts for Claude Code with automatic language detection, task type recognition, and interactive refinement capabilities. Works entirely offline without external API dependencies to transform natural language requests into structured, Claude Code-optimized prompts.

Related MCP Servers

TranscriptionTools MCP Server
MushroomFleet
A
security
A
license
A
quality
Provides intelligent transcript processing capabilities for Claude, featuring natural formatting, contextual repair, and smart summarization powered by Deep Thinking LLMs.
Last updated -
4
15
TypeScript
MIT License
code2prompt
mufeedvh
-
security
A
license
-
quality
A code ingestion tool that transforms your code into AI-optimized prompts instantly. Gather the relevant context with code2prompt under the hood. Learn more at code2prompt.dev
Last updated -
6,214
MIT License
MCP Prompt Enhancer Server
S3bRR
-
security
F
license
-
quality
Transforms simple prompts into detailed, professional specifications using AI, designed to get better results from Claude, ChatGPT, and other AI assistants.
Last updated -
TypeScript
Claude Jester MCP
mstanton
-
security
F
license
-
quality
Transforms Claude from a code generator into a programming partner capable of testing, debugging, and optimizing code automatically through a secure execution environment.
Last updated -
Python

View all related MCP servers