# atest-mcp-server

Wires your coding agent to atest so API tests can be run and inspected from the chat. Useful when your test suite already lives in atest.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: LinuxSuRen
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LinuxSuRen/atest-mcp-server
- Updated: 2025-11-11
- HTML: https://affpapa.org/en/nevibecode/mcp/atest-mcp-server

## What it does

This MCP server sits between an AI agent and atest, the API testing tool. The agent talks to it over MCP and drives tests through the atest gRPC port.

Three ways to start it: the `atest-store-mcp` binary, a Docker container, or `npx atest-mcp-server-launcher@latest`. Transport is picked with `--mode`, either `sse` or `stdio`. In an MCP config, streamableHttp points at a `baseUrl` such as `http://localhost:7845`; the stdio entry runs `atest-store-mcp` with `server`, `-m=stdio` and a runner address.

Nothing works until an atest runner is listening on `127.0.0.1:64385` — that address goes into `--runner-address`, so swap in your own. Building the binary takes `make build`; packing a `.dxt` file needs `@anthropic-ai/dxt` installed globally.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add atest-mcp-server -- npx -y atest-mcp-server-launcher
```

### Codex

**Platform CLI**
```bash
codex mcp add atest-mcp-server -- npx -y atest-mcp-server-launcher
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atest-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "atest-mcp-server-launcher"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atest-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "atest-mcp-server-launcher"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add atest-mcp-server npx -y atest-mcp-server-launcher
```

## When to use it
- run atest API tests without leaving the agent chat
- hook atest up to an agent over stdio or streamableHttp
- start the server in Docker next to the runner
- pack a `.dxt` bundle for the server
- switch transport with the `--mode` flag

## Example prompts
- Run the atest API tests and show me what failed
- Start atest-mcp-server in stdio mode against the runner on `localhost:64385`
- Execute the atest suite and walk me through the failing responses

## Similar
- [bruno-collection-generator](https://affpapa.org/en/nevibecode/skills/bruno-collection-generator.md) — skill · 603 installs
- [Multimeter](https://affpapa.org/en/nevibecode/mcp/multimeter.md) — MCP server · ★ 11
- [bmad-qa-generate-e2e-tests](https://affpapa.org/en/nevibecode/skills/bmad-qa-generate-e2e-tests.md) — skill · 11600 installs
- [wp-abilities-verify](https://affpapa.org/en/nevibecode/skills/wp-abilities-verify.md) — skill · 2600 installs
- [api-contract-testing](https://affpapa.org/en/nevibecode/skills/api-contract-testing.md) — skill · 913 installs
- [test-automator](https://affpapa.org/en/nevibecode/agents/test-automator.md) — subagent · 625 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md