# @meeseeks-sdk/mcp

> MCP server for Claude Code — makes the AI verify its own code before giving it to you.

[![npm version](https://img.shields.io/npm/v/@meeseeks-sdk/mcp)](https://www.npmjs.com/package/@meeseeks-sdk/mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## What it does

Instead of Claude Code giving you the first code it generates, this MCP runs a quality gate:

```
Claude Code calls quality_gate tool
        ↓
LLM generates code
        ↓
Sandbox executes it (real Node.js subprocess)
        ↓
Score 0-10 based on correctness + efficiency
        ↓
Score ≥ 8? → return verified code
Score < 8? → feed failures back to LLM → retry
```

You get code that already survived real execution — not just what looked good at first glance.

## Install

```bash
npm install -g @meeseeks-sdk/mcp
```

## Setup with Claude Code

```bash
claude mcp add meeseeks --scope user npx @meeseeks-sdk/mcp
```

That's it. The `quality_gate` tool is now available in all your Claude Code sessions.

## Tell Claude when to use it

Add to your project's `CLAUDE.md` or `~/.claude/CLAUDE.md`:

```markdown
## Code Generation

When writing isolated utility functions or algorithms (any language),
use the meeseeks__quality_gate tool instead of writing directly.
Use mode: "fast" if the pattern was used before, "balanced" for new tasks.
For Dart/Flutter/Python code: always pass harness: "free".
For JS/Node.js utilities: omit harness (auto-detected).
```

## Tool: `quality_gate`

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `task` | `string` | required | What to build — be specific about function signature and export format |
| `mode` | `fast\|balanced\|quality` | `fast` | fast=1 iter, balanced=3, quality=5 |
| `harness` | `string` | auto-detected | `js-api`, `js-lrucache`, `js-ratelimiter`, `js-circuitbreaker`, `js-promisepool`, `js-maze`, `js-sudoku`, `js-wordle`, `free` |
| `projectContext` | `string` | — | Stack description for the judge: `"TypeScript + Express + PostgreSQL"` |
| `minScore` | `number` | `8` | Stop when score ≥ this value |

## Requirements

- Node.js 18+
- AWS credentials configured (`~/.aws/credentials`) for Bedrock adapter
- Or set `AWS_REGION` environment variable

## Knowledge inheritance

The MCP stores winning strategies in `~/.meeseeks/memory.db` (SQLite). Next time you ask for a similar function, the proven approach is injected into the prompt — better first attempts over time.

## Powered by

[@meeseeks-sdk/core](https://www.npmjs.com/package/@meeseeks-sdk/core) — the quality gate engine extracted from [Meeseeks Hive](https://github.com/abrahamcasanova/meeseeks-hive).

## License

MIT