# Test Shape MCP

> Test Shape MCP is an open-source MCP server for developer tools. MCP server that audits the structure of local test suites over stdio. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/mrfentmen/awesome-servers
- **MCP Registry name:** io.github.mrfentmen/test-shape-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add test-shape-mcp -- npx -y test-shape-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "test-shape-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "test-shape-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "test-shape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "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.

## Alternatives

- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [Test](https://ai-powered.com/mcp/test-2): Test is an open-source MCP server for developer tools.
- [Srecode Template MCP](https://ai-powered.com/mcp/srecode-template-mcp): Srecode Template MCP is an open-source MCP server for developer tools.
- [MCP Compliance](https://ai-powered.com/mcp/mcp-compliance): MCP Compliance is an open-source MCP server for security.
- [Velocity Template Language MCP](https://ai-powered.com/mcp/velocity-template-language-mcp): Velocity Template Language MCP is an open-source MCP server for developer tools.
- [TrustedMCP](https://ai-powered.com/mcp/trustedmcp): TrustedMCP is a free MCP server for security.
- [MCPfinder - MCP Server Discovery](https://ai-powered.com/mcp/mcpfinder-mcp-server-discovery): MCPfinder - MCP Server Discovery is an open-source MCP server for developer tools.
- [MCP Failure Lab](https://ai-powered.com/mcp/mcp-failure-lab-2): MCP Failure Lab is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/test-shape-mcp
