Skip to content
MCP server

Test Shape MCP

MCP server that audits the structure of local test suites over stdio

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers