A Model Context Protocol (MCP) server that refines your prompts using PromptArchitect's AI-powered prompt engineering. Simply pass your current prompt and get an improved version back. Works with: Claude Desktop • VS Code (Copilot) • Cursor • Windsurf • Zed • JetBrains IDEs • Continue.dev • Cline Unlike generic prompt tools, PromptArchitect understands your project context. When refining prompts,
Add this skill
npx mdskills install MerabyLabs/promptarchitect-mcpWell-documented MCP server with three useful prompt engineering tools and excellent IDE integration examples
1# @merabylabs/promptarchitect-mcp23[](https://www.npmjs.com/package/@merabylabs/promptarchitect-mcp)4[](https://modelcontextprotocol.io)56A Model Context Protocol (MCP) server that refines your prompts using PromptArchitect's AI-powered prompt engineering. Simply pass your current prompt and get an improved version back.78**Works with:** Claude Desktop • VS Code (Copilot) • Cursor • Windsurf • Zed • JetBrains IDEs • Continue.dev • Cline910## ✨ Why PromptArchitect MCP?1112### 🎯 Workspace-Aware Refinement1314Unlike generic prompt tools, PromptArchitect understands **your project context**. When refining prompts, it considers:1516- **Your tech stack** — React, Node, Python, or whatever you're building with17- **Project structure** — File organization, naming conventions, architecture patterns18- **Dependencies** — Libraries and frameworks from your package.json/requirements.txt19- **Your original request** — Ensures refined prompts stay aligned with your actual goal2021This means prompts are tailored to **your specific codebase**, not generic boilerplate.2223### 🚀 Key Benefits2425- **No API key required** — Free to use, powered by PromptArchitect backend26- **Works in your IDE** — Integrates with your existing workflow via MCP27- **Context-aware** — Prompts that understand your project conventions28- **Iterative refinement** — Keep improving until it's perfect2930## Features3132### 🛠️ Tools3334| Tool | Description |35|------|-------------|36| `refine_prompt` | Improve your current prompt based on feedback and your workspace context |37| `analyze_prompt` | Evaluate prompt quality with scores and improvement suggestions |38| `generate_prompt` | Transform a raw idea into a well-structured prompt tailored to your project |3940### 📦 Resources4142- **Template Library**: Reference templates for coding, writing, research, and analysis tasks43- **Category Collections**: Browse templates by category for inspiration4445## Installation4647```bash48npm install @merabylabs/promptarchitect-mcp49```5051Or install globally:5253```bash54npm install -g @merabylabs/promptarchitect-mcp55```5657## Usage5859PromptArchitect MCP server works with any IDE or application that supports the [Model Context Protocol](https://modelcontextprotocol.io). Below are configuration examples for popular editors.6061> **No API key required!** The MCP server uses the PromptArchitect backend API, so you don't need your own Gemini API key.6263---6465### Claude Desktop6667Add to your Claude Desktop configuration file:68- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`69- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`7071```json72{73 "mcpServers": {74 "promptarchitect": {75 "command": "npx",76 "args": ["@merabylabs/promptarchitect-mcp"]77 }78 }79}80```8182---8384### VS Code (GitHub Copilot)8586Add to your VS Code `settings.json` (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)"):8788```json89{90 "github.copilot.chat.mcp.servers": {91 "promptarchitect": {92 "command": "npx",93 "args": ["@merabylabs/promptarchitect-mcp"]94 }95 }96}97```9899---100101### Cursor102103Add to your Cursor MCP settings:104- **macOS/Linux**: `~/.cursor/mcp.json`105- **Windows**: `%USERPROFILE%\.cursor\mcp.json`106- Or via: Settings → MCP107108```json109{110 "mcpServers": {111 "promptarchitect": {112 "command": "npx",113 "args": ["@merabylabs/promptarchitect-mcp"]114 }115 }116}117```118119📖 [Cursor MCP Documentation](https://docs.cursor.com/advanced/model-context-protocol)120121---122123### Windsurf (Codeium)124125Add to your Windsurf MCP configuration:126- **macOS/Linux**: `~/.codeium/windsurf/mcp_config.json`127- **Windows**: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`128129```json130{131 "mcpServers": {132 "promptarchitect": {133 "command": "npx",134 "args": ["@merabylabs/promptarchitect-mcp"]135 }136 }137}138```139140📖 [Windsurf MCP Documentation](https://docs.codeium.com/windsurf/mcp)141142---143144### Zed145146Add to your Zed settings:147- **macOS**: `~/.config/zed/settings.json`148- **Linux**: `~/.config/zed/settings.json`149150```json151{152 "context_servers": {153 "promptarchitect": {154 "command": {155 "path": "npx",156 "args": ["@merabylabs/promptarchitect-mcp"]157 },158 "settings": {}159 }160 }161}162```163164📖 [Zed MCP Documentation](https://zed.dev/docs/assistant/model-context-protocol)165166---167168### JetBrains IDEs169170Works with **IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, RubyMine, CLion, DataGrip, Rider, Android Studio**.1711721. Install the **MCP Client** plugin from JetBrains Marketplace1732. Go to Settings → Tools → MCP Servers1743. Add a new server with this configuration:175176```json177{178 "mcpServers": {179 "promptarchitect": {180 "command": "npx",181 "args": ["@merabylabs/promptarchitect-mcp"]182 }183 }184}185```186187Or add to `.idea/mcp.json` in your project.188189📖 [JetBrains MCP Plugin](https://plugins.jetbrains.com/plugin/mcp-client)190191---192193### Continue.dev194195Add to your Continue configuration:196- **Global**: `~/.continue/config.json`197- **Project**: `.continue/config.json`198199```json200{201 "experimental": {202 "modelContextProtocolServers": [203 {204 "transport": {205 "type": "stdio",206 "command": "npx",207 "args": ["@merabylabs/promptarchitect-mcp"]208 }209 }210 ]211 }212}213```214215📖 [Continue MCP Documentation](https://docs.continue.dev/customize/model-context-protocol)216217---218219### Cline (VS Code Extension)220221Open Cline Settings → MCP Servers, or edit `cline_mcp_settings.json`:222223```json224{225 "mcpServers": {226 "promptarchitect": {227 "command": "npx",228 "args": ["@merabylabs/promptarchitect-mcp"],229 "disabled": false230 }231 }232}233```234235📖 [Cline MCP Documentation](https://github.com/cline/cline#mcp-support)236237---238239### Other MCP-Compatible Applications240241Any application supporting MCP can use this server. The standard configuration is:242243| Property | Value |244|----------|-------|245| Command | `npx` |246| Args | `["@merabylabs/promptarchitect-mcp"]` |247248For global installation, use `promptarchitect-mcp` as the command after running:249```bash250npm install -g @merabylabs/promptarchitect-mcp251```252253---254255### Programmatic Usage256257```typescript258import { refinePrompt, analyzePrompt } from '@promptarchitect/mcp-server';259260// Refine an existing prompt261const result = await refinePrompt({262 prompt: 'Write code to sort an array',263 feedback: 'Make it more specific about language and edge cases',264});265266console.log(result.refinedPrompt);267// => "Write a TypeScript function that sorts an array of numbers..."268269// Analyze prompt quality270const analysis = await analyzePrompt({271 prompt: 'Help me with my code',272});273console.log(analysis.scores); // { overall: 45, clarity: 50, ... }274console.log(analysis.suggestions); // ["Be more specific about...", ...]275```276277## Configuration278279### Environment Variables280281| Variable | Required | Description |282|----------|----------|-------------|283| `LOG_LEVEL` | No | Logging level: `debug`, `info`, `warn`, `error`. Default: `info` |284285## Tool Reference286287### refine_prompt288289Improve an existing prompt based on feedback. **This is the primary tool.**290291**Input:**292```json293{294 "prompt": "Write code",295 "feedback": "Make it more specific and add examples",296 "preserveStructure": true297}298```299300**Output:**301```json302{303 "refinedPrompt": "Write a TypeScript function that...",304 "changes": ["Added specificity", "Included example"],305 "metadata": {306 "originalWordCount": 2,307 "refinedWordCount": 45308 }309}310```311312### analyze_prompt313314Evaluate prompt quality and get improvement suggestions.315316**Input:**317```json318{319 "prompt": "You are a helpful assistant. Help me write code."320}321```322323**Output:**324```json325{326 "scores": {327 "overall": 65,328 "clarity": 70,329 "specificity": 50,330 "structure": 60,331 "actionability": 80332 },333 "suggestions": [334 "Add more specific details about the code",335 "Include examples of expected output"336 ],337 "strengths": ["Clear action verb"],338 "weaknesses": ["Lacks specificity"]339}340```341342### generate_prompt343344Transform a raw idea into a well-structured prompt.345346**Input:**347```json348{349 "idea": "Create a code review assistant",350 "template": "coding",351 "context": "For TypeScript projects"352}353```354355**Output:**356```json357{358 "prompt": "You are a senior code reviewer...",359 "metadata": {360 "template": "coding",361 "wordCount": 150,362 "hasStructure": true363 }364}365```366367## Development368369### Building370371```bash372npm install373npm run build374```375376### Testing377378```bash379npm test380```381382### Running Locally383384```bash385npm start386```387388## Architecture389390```391mcp-server/392├── src/393│ ├── tools/ # MCP tools (refine, analyze, generate)394│ ├── resources/ # Template library for reference395│ ├── utils/ # Gemini client, logger396│ ├── server.ts # MCP server configuration397│ ├── cli.ts # CLI entry point398│ └── index.ts # Main exports399└── examples/ # Configuration examples400```401402## License403404Proprietary - © 2025 Meraby Labs. All rights reserved.405406This software is provided for use exclusively with the PromptArchitect service. Unauthorized copying, modification, distribution, or use outside the intended scope is prohibited.407408## Related409410- [PromptArchitect](https://promptarchitectlabs.com/) - Full web application411- [Model Context Protocol](https://modelcontextprotocol.io) - MCP specification412- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) - SDK used by this server413414
Full transparency — inspect the skill content before installing.