vibe-check-mcp-server

# Agent Quickstart

Vibe Check MCP is a lightweight oversight layer for AI agents. It exposes two tools:

- **vibe_check** – prompts you with clarifying questions to prevent tunnel vision.
- **vibe_learn** – optional logging of mistakes and successes for later review.

The server supports Gemini, OpenAI, Anthropic, and OpenRouter LLMs. History is maintained across requests when a `sessionId` is provided.

## Setup

1. Install dependencies and build:
   ```bash
   npm install
   npm run build
   ```
2. Supply the following environment variables as needed:
   - `GEMINI_API_KEY`
   - `OPENAI_API_KEY`
   - `OPENROUTER_API_KEY`
   - `ANTHROPIC_API_KEY` *(official Anthropic deployments)*
   - `ANTHROPIC_AUTH_TOKEN` *(Anthropic-compatible proxies)*
   - `ANTHROPIC_BASE_URL` *(optional; defaults to https://api.anthropic.com)*
   - `ANTHROPIC_VERSION` *(optional; defaults to 2023-06-01)*
   - `DEFAULT_LLM_PROVIDER` (gemini | openai | openrouter | anthropic)
   - `DEFAULT_MODEL` (e.g., gemini-3.6-flash; leave unset for the provider default)
3. Start the server:
   ```bash
   npm start
   ```

## Testing

Run unit tests with `npm test`. The JSON-RPC compatibility shim mitigates missing `id` fields on `tools/call` requests so the standard SDK client and Windsurf work without extra tooling, but compliant clients should continue to send their own identifiers. Example request generators remain available if you want canned payloads for manual testing:

- `alt-test-gemini.js`
- `alt-test-openai.js`
- `alt-test.js` (OpenRouter)

Each script writes a `request.json` file that you can pipe to the server:

```bash
node build/index.js < request.json
```

## Integration Tips

Call `vibe_check` regularly with your goal, plan and current progress. Use `vibe_learn` whenever you want to record a resolved issue. Full API details are in `docs/technical-reference.md`.