Test Shape MCP
MCP server that audits the structure of local test suites over stdio
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 1.0.1
- Listing updated
- today
Similar MCP servers
About Test Shape MCP
Test Shape MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Test Shape MCP is a small stdio server distributed as the npm package test-shape-mcp (version 1.0.1). According to its registry entry, it audits local test structure and reports on it in aggregate, so an AI client can inspect how a project's tests are organized without the user reading every file.
It runs locally with no remote endpoint and needs no environment variables. It is one of many servers in the author's awesome-servers repository, a collection of TypeScript MCP servers that each ship as their own npm package. The repository README says its servers are meant to be small, tested and self-contained, and that nothing in the repo asks callers to pay.
The registry entry does not list individual tool names, so the exact checks it performs are not documented here. It suits developers who want an MCP-capable assistant to review test layout in a local codebase.
Install
Run in a terminal
claude mcp add test-shape-mcp -- npx -y test-shape-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"test-shape-mcp": {
"command": "npx",
"args": [
"-y",
"test-shape-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"test-shape-mcp": {
"command": "npx",
"args": [
"-y",
"test-shape-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"test-shape-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"test-shape-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"test-shape-mcp": {
"command": "npx",
"args": [
"-y",
"test-shape-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"test-shape-mcp": {
"command": "npx",
"args": [
"-y",
"test-shape-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Local test structure audit
- Inspects the structure of tests on the local machine and summarizes it in aggregate.
- Stdio transport
- Runs as a local process that MCP clients talk to over standard input and output.
- npm distribution
- Published as the `test-shape-mcp` package, so it can be installed and launched with npm tooling.
- No configuration variables
- The registry entry declares no required environment variables or API keys.
Good for
- Reviewing how a project's test files are organized through an AI assistant
- Spotting structural gaps in a local test suite before a refactor
- Giving an MCP client an overview of test layout when onboarding to a codebase
Pricing
Open source
The source repository states that nothing in it asks a caller to pay
Test Shape MCP FAQ
How does Test Shape MCP run?
It runs locally over stdio and is installed from npm as the package test-shape-mcp; there is no remote endpoint.
Does it need an API key?
No. The registry entry lists no environment variables.
Which version is listed?
The registry entry lists npm package version 1.0.1.
Where does the source live?
It comes from the mrfentmen/awesome-servers repository on GitHub, which collects many MCP servers.
Is Test Shape MCP free?
Yes. Test Shape MCP is open source, so you can use and self-host it for free.
How do I add Test Shape MCP to Claude Code?
Run this command in your terminal: claude mcp add test-shape-mcp -- npx -y test-shape-mcp
What are the best alternatives to Test Shape MCP?
The closest alternatives to Test Shape MCP are Makefile MCP, Test, Srecode Template MCP, MCP Compliance and Velocity Template Language MCP.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.