@merabylabs/promptarchitect-mcp

Prompt Lab for MCP — AI-powered prompt engineering for your IDE

A Model Context Protocol (MCP) server that refines your prompts using PromptArchitect's AI-powered prompt engineering. Part of the Prompt Lab ecosystem — Craft, Polish, Execute.

Works with: Claude Desktop • VS Code (Copilot) • Cursor • Windsurf • Zed • JetBrains IDEs • Continue.dev • Cline

🔗 Part of the Prompt Lab Ecosystem

| Product | Description | |---------|-------------| | PromptArchitect MCP | This package — MCP server for IDE integration | | VS Code Extension | Full Prompt Lab panel with 3-step workflow | | Web App | Full-featured web application |

✨ Why PromptArchitect MCP?

🎯 Workspace-Aware Refinement

Unlike generic prompt tools, PromptArchitect understands your project context. When refining prompts, it considers:

• Your tech stack — React, Node, Python, or whatever you're building with
• Project structure — File organization, naming conventions, architecture patterns
• Dependencies — Libraries and frameworks from your package.json/requirements.txt
• Your original request — Ensures refined prompts stay aligned with your actual goal

This means prompts are tailored to your specific codebase, not generic boilerplate.

🚀 Key Benefits

• No API key required — Free to use, powered by PromptArchitect backend
• Works in your IDE — Integrates with your existing workflow via MCP
• Context-aware — Prompts that understand your project conventions
• Iterative refinement — Keep improving until it's perfect

Features

🛠️ Tools

| Tool | Description | |------|-------------| | refine_prompt | Improve your current prompt based on feedback and your workspace context | | analyze_prompt | Evaluate prompt quality with scores and improvement suggestions | | generate_prompt | Transform a raw idea into a well-structured prompt tailored to your project | | set_auto_refine | Enable/disable automatic prompt refinement on every chat | | get_auto_refine_status | Check current auto-refine settings |

🔄 Auto-Refine Mode

Enable automatic prompt refinement so every prompt you write gets refined before processing—no need to explicitly ask!

You: enable auto-refine
AI: ✅ Auto-refine enabled. All prompts will now be automatically refined.

You: help me debug my React component
AI: [Automatically refines prompt to be more specific, then helps you]

How it works:

1. Say "enable auto-refine" or use the set_auto_refine tool
2. Every subsequent prompt is automatically refined with your project context
3. The AI uses the improved prompt to give you better responses
4. Say "disable auto-refine" to turn it off

This is perfect for developers who want consistently high-quality prompts without extra effort.

📦 Resources

• Template Library: Reference templates for coding, writing, research, and analysis tasks
• Category Collections: Browse templates by category for inspiration

Installation

npm install @merabylabs/promptarchitect-mcp

Or install globally:

npm install -g @merabylabs/promptarchitect-mcp

Usage

PromptArchitect MCP server works with any IDE or application that supports the Model Context Protocol. Below are configuration examples for popular editors.

No API key required! The MCP server uses the PromptArchitect backend API, so you don't need your own Gemini API key.

Claude Desktop

Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Add to your VS Code settings.json (Cmd/Ctrl+Shift+P → "Preferences: Open Settings (JSON)"):

{
  "github.copilot.chat.mcp.servers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json
• Or via: Settings → MCP

{
  "mcpServers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"]
    }
  }
}

📖 Cursor MCP Documentation

Windsurf (Codeium)

Add to your Windsurf MCP configuration:

• macOS/Linux: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"]
    }
  }
}

📖 Windsurf MCP Documentation

Zed

Add to your Zed settings:

• macOS: ~/.config/zed/settings.json
• Linux: ~/.config/zed/settings.json

{
  "context_servers": {
    "promptarchitect": {
      "command": {
        "path": "npx",
        "args": ["@merabylabs/promptarchitect-mcp"]
      },
      "settings": {}
    }
  }
}

📖 Zed MCP Documentation

JetBrains IDEs

Works with IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, RubyMine, CLion, DataGrip, Rider, Android Studio.

1. Install the MCP Client plugin from JetBrains Marketplace
2. Go to Settings → Tools → MCP Servers
3. Add a new server with this configuration:

{
  "mcpServers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"]
    }
  }
}

Or add to .idea/mcp.json in your project.

📖 JetBrains MCP Plugin

Continue.dev

Add to your Continue configuration:

• Global: ~/.continue/config.json
• Project: .continue/config.json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["@merabylabs/promptarchitect-mcp"]
        }
      }
    ]
  }
}

📖 Continue MCP Documentation

Cline (VS Code Extension)

Open Cline Settings → MCP Servers, or edit cline_mcp_settings.json:

{
  "mcpServers": {
    "promptarchitect": {
      "command": "npx",
      "args": ["@merabylabs/promptarchitect-mcp"],
      "disabled": false
    }
  }
}

📖 Cline MCP Documentation

Other MCP-Compatible Applications

Any application supporting MCP can use this server. The standard configuration is:

| Property | Value | |----------|-------| | Command | npx | | Args | ["@merabylabs/promptarchitect-mcp"] |

For global installation, use promptarchitect-mcp as the command after running:

npm install -g @merabylabs/promptarchitect-mcp

Programmatic Usage

import { refinePrompt, analyzePrompt } from '@promptarchitect/mcp-server';

// Refine an existing prompt
const result = await refinePrompt({
  prompt: 'Write code to sort an array',
  feedback: 'Make it more specific about language and edge cases',
});

console.log(result.refinedPrompt);
// => "Write a TypeScript function that sorts an array of numbers..."

// Analyze prompt quality
const analysis = await analyzePrompt({
  prompt: 'Help me with my code',
});
console.log(analysis.scores); // { overall: 45, clarity: 50, ... }
console.log(analysis.suggestions); // ["Be more specific about...", ...]

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | LOG_LEVEL | No | Logging level: debug, info, warn, error. Default: info |

Tool Reference

refine_prompt

Improve an existing prompt based on feedback. This is the primary tool.

Input:

{
  "prompt": "Write code",
  "feedback": "Make it more specific and add examples",
  "preserveStructure": true
}

Output:

{
  "refinedPrompt": "Write a TypeScript function that...",
  "changes": ["Added specificity", "Included example"],
  "metadata": {
    "originalWordCount": 2,
    "refinedWordCount": 45
  }
}

analyze_prompt

Evaluate prompt quality and get improvement suggestions.

Input:

{
  "prompt": "You are a helpful assistant. Help me write code."
}

Output:

{
  "scores": {
    "overall": 65,
    "clarity": 70,
    "specificity": 50,
    "structure": 60,
    "actionability": 80
  },
  "suggestions": [
    "Add more specific details about the code",
    "Include examples of expected output"
  ],
  "strengths": ["Clear action verb"],
  "weaknesses": ["Lacks specificity"]
}

generate_prompt

Transform a raw idea into a well-structured prompt.

Input:

{
  "idea": "Create a code review assistant",
  "template": "coding",
  "context": "For TypeScript projects"
}

Output:

{
  "prompt": "You are a senior code reviewer...",
  "metadata": {
    "template": "coding",
    "wordCount": 150,
    "hasStructure": true
  }
}

Development

Building

npm install
npm run build

Testing

npm test

Running Locally

npm start

Architecture

mcp-server/
├── src/
│   ├── tools/           # MCP tools (refine, analyze, generate)
│   ├── resources/       # Template library for reference
│   ├── utils/           # Gemini client, logger
│   ├── server.ts        # MCP server configuration
│   ├── cli.ts           # CLI entry point
│   └── index.ts         # Main exports
└── examples/            # Configuration examples

License

Proprietary - © 2025 Meraby Labs. All rights reserved.

This software is provided for use exclusively with the PromptArchitect service. Unauthorized copying, modification, distribution, or use outside the intended scope is prohibited.

Related

• PromptArchitect - Full web application
• Model Context Protocol - MCP specification
• MCP TypeScript SDK - SDK used by this server