@vitest-agent/mcp
v1.3.6
Published
Model Context Protocol server for vitest-agent. Exposes 53 tools for agent access to test data, TDD lifecycle, and session management.
Maintainers
Readme
@vitest-agent/mcp
Part of the vitest-agent ecosystem. Most users want @vitest-agent/plugin, which pulls this package in automatically. Install
@vitest-agent/mcpdirectly only if you run the MCP server standalone.
The vitest-agent-mcp MCP server bin. Exposes action-keyed tools over stdio that give LLM agents structured access to test data, coverage, history, failure signatures, TDD lifecycle state and more. Also surfaces six framing-only prompts.
Features
- 29 action-keyed tools — per-CRUD families collapse into single tools dispatching on an
actiondiscriminator; coverstest_status,test_overview,test_coverage,test_errors,run_tests,note,hypothesis,tdd_task,tdd_goal,tdd_behaviorand more - Six framing prompts —
triage,why-flaky,regression-since-pass,explain-failure,tdd-resume,wrapup - Idempotency middleware —
tdd_task,tdd_goal,tdd_behaviorandhypothesiscreate-actions are idempotent on derived keys
Install
npm install --save-dev @vitest-agent/mcp
# or
pnpm add -D @vitest-agent/mcp@vitest-agent/mcp is a regular dependency of @vitest-agent/plugin and installs with it automatically.
Quick start
npx vitest-agent-mcp
# starts the MCP server over stdio
# example output (varies by environment)The server reads the SQLite database written by AgentPlugin via the same XDG-derived path, so a single test run populates data for all tools.
Documentation
MCP reference and tool catalog at vitest-agent.dev/mcp.
