BetterPrompt MCP Server

![CI/CD Pipeline](https://github.com/AungMyoKyaw/betterprompt-mcp/actions/workflows/ci.yml) ![npm version](https://www.npmjs.com/package/betterprompt-mcp) ![MCP Compatible](https://modelcontextprotocol.io/) ![Node.js Version](https://nodejs.org/) ![TypeScript](https://www.typescriptlang.org/) ![License: MIT](https://opensource.org/licenses/MIT)

---

Overview
Quickstart
Installation
Tool
Usage Example
Client Integration
How It Works
Development
License
Support

---

Overview

BetterPrompt MCP is a Model Context Protocol (MCP) server that enhances user requests using advanced prompt engineering techniques. It exposes a single, powerful tool that transforms simple requests into structured, context-rich instructions tailored for optimal AI model performance.

Instead of manually crafting detailed prompts, BetterPrompt MCP converts your requests into expertly engineered prompts that get better results from AI models.

Before & After Example

Without BetterPrompt:

"Write a function to calculate fibonacci numbers"

With BetterPrompt Enhancement:

"You are a world-class AI assistant with expertise in advanced prompt engineering techniques from top AI research labs like Anthropic, OpenAI, and Google DeepMind.

Your task is to provide an exceptional response to the following user request:

"Write a function to calculate fibonacci numbers"

Please enhance your response by:

Analyzing the intent and requirements behind this request
Applying appropriate prompt engineering techniques to ensure maximum effectiveness
Adding clarity, specificity, and structure to your approach
Including relevant context and constraints for comprehensive understanding
Ensuring optimal interaction patterns for complex reasoning tasks
Specifying the most appropriate output format for the task
Defining clear success criteria for high-quality results

Structure your response with clear headings, detailed explanations, and examples where appropriate. Ensure your answer is comprehensive, actionable, and directly addresses all aspects of the request."

---

Quickstart

Install and run via npx:

npx -y betterprompt-mcp

Or add to your MCP client configuration:

{
  "mcpServers": {
    "betterprompt": {
      "command": "npx",
      "args": ["-y", "betterprompt-mcp"]
    }
  }
}

---

Installation

Most MCP clients work with this standard config:

{
  "mcpServers": {
    "betterprompt": {
      "command": "npx",
      "args": ["-y", "betterprompt-mcp"]
    }
  }
}

Pick your client below. Where available, click the install button; otherwise follow the manual steps.

Click a button to install:

Fallback (CLI):

code --add-mcp '{"name":"betterprompt","command":"npx","args":["-y","betterprompt-mcp"]}'

Docs: Add an MCP server

</details>

<details> <summary>Cursor</summary>

Click to install:

Or add manually: Settings → MCP → Add new MCP Server → Type: command, Command: npx -y betterprompt-mcp.

</details>

<details> <summary>LM Studio</summary>

Click to install:

![Add MCP Server betterprompt to LM Studio](https://lmstudio.ai/install-mcp?name=betterprompt&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImJldHRlcnByb21wdC1tY3AiXX0%3D)

Or manually: Program → Install → Edit mcp.json, add the standard config above.

</details>

<details> <summary>Continue</summary>

Install button: TODO – no public deeplink available yet.

Manual setup:

Open Continue Settings → open JSON configuration
Add mcpServers entry:

{
  "mcpServers": {
    "betterprompt": {
      "command": "npx",
      "args": ["-y", "betterprompt-mcp"]
    }
  }
}

Restart Continue if needed.

</details>

<details> <summary>Goose</summary>

Click to install:

![Install in Goose](https://block.github.io/goose/extension?cmd=npx&arg=-y&arg=betterprompt-mcp&id=betterprompt&name=BetterPrompt&description=Enhance%20prompts%20with%20advanced%20techniques%20for%20MCP%20clients)

Or manually: Advanced settings → Extensions → Add custom extension → Type: STDIO → Command: npx -y betterprompt-mcp.

</details>

<details> <summary>Claude Code (CLI)</summary>

Install via CLI:

claude mcp add betterprompt npx -y betterprompt-mcp

</details>

<details> <summary>Claude Desktop</summary>

Add to claude_desktop_config.json using the standard config above, then restart Claude Desktop. See the MCP quickstart:

Model Context Protocol – Quickstart

</details>

<details> <summary>Windsurf</summary>

Follow the Windsurf MCP documentation and use the standard config above.

Docs: Windsurf MCP

</details>

<details> <summary>Gemini CLI</summary>

Follow the Gemini CLI MCP server guide; use the standard config above.

Docs: Configure MCP server in Gemini CLI

</details>

Open Qodo Gen chat panel → Connect more tools → + Add new MCP → Paste the standard config above → Save.

Qodo Gen documentation

</details>

<details> <summary>opencode</summary>

Create or edit ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "betterprompt": {
      "type": "local",
      "command": ["npx", "-y", "betterprompt-mcp"],
      "enabled": true
    }
  }
}

opencode MCP documentation

</details>

---

Tool

`enhance-request`

Transforms user requests into world-class AI-enhanced prompts using advanced prompt engineering techniques.

Input:

request (string, required): The user request to transform into an enhanced AI prompt

Output: AI-enhanced prompt with structure, context, and clear instructions.

Example Usage:

{
  "name": "enhance-request",
  "arguments": {
    "request": "Write a function to calculate fibonacci numbers"
  }
}

---

Usage Example

Request:

{
  "name": "enhance-request",
  "arguments": {
    "request": "Explain quantum computing"
  }
}

Enhanced Result:

"You are a world-class AI assistant with expertise in advanced prompt engineering techniques from top AI research labs like Anthropic, OpenAI, and Google DeepMind.

Your task is to provide an exceptional response to the following user request:

"Explain quantum computing"

Please enhance your response by:

Analyzing the intent and requirements behind this request
Applying appropriate prompt engineering techniques to ensure maximum effectiveness
Adding clarity, specificity, and structure to your approach
Including relevant context and constraints for comprehensive understanding
Ensuring optimal interaction patterns for complex reasoning tasks
Specifying the most appropriate output format for the task
Defining clear success criteria for high-quality results

---

How It Works

BetterPrompt MCP leverages the MCP Sampling API to enhance user requests:

When you call the enhance-request tool, the server sends a sampling request to your MCP client
Your client uses its configured LLM to enhance the prompt using advanced prompt engineering techniques
The enhanced prompt is returned to you for use with any AI model

This approach has several benefits:

No API keys required - uses your client's existing LLM configuration
Leverages the most capable model available in your client
Works with any MCP-compatible client (Claude Desktop, VS Code, Cursor, etc.)
Always up-to-date with the latest prompt engineering techniques

---

Development

Project Structure

betterprompt-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── tests/                # Test files and verification scripts
├── dist/                 # Compiled output (generated)
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md             # Documentation

Build & Development

Build:

npm run build

Watch (dev):

npm run watch

Format:

npm run format
npm run format:check

Test:

npm run test:comprehensive

Linting and Formatting

We use ESLint + Prettier to keep the codebase consistent.

Run the linter locally: npm run lint
Apply autofixes: npm run lint -- --fix or npm run lint:fix
Run the CI-oriented lint (JSON output): npm run lint:ci (produces artifacts/lint-report.json)
Autofix auto-commit policy: safe, formatting-only autofixes are auto-committed using scripts/lint-autofix-and-commit.sh. The script uses a conservative heuristic (small change threshold) and will abort auto-commit when changes appear large or potentially behavior-affecting; in such cases open a PR for human review.

License

MIT License

---

Support

For questions or issues, open an issue on GitHub or contact the author via GitHub profile.

---

Author

Aung Myo Kyaw (GitHub)

betterprompt-mcp