open-index/open-npm huggingface dataset:
npm package: @mcp-workbench/cli
Description: MCP Workbench — test, inspect, and validate MCP servers
Latest version: 0.5.1

# MCP Workbench

**A quality platform for MCP server developers.**

Test, inspect, and validate [Model Context Protocol](https://modelcontextprotocol.io) servers — from the command line or in CI.

## Install

```bash
# Preferred
npm install -g @mcp-workbench/cli

# Alternative convenience package
npm install -g mcp-workbench-cli
```

Both provide the same `mcp-workbench` command.

> **Why not `npm install -g mcp-workbench`?**
> The unscoped name is taken by an unrelated project. See [npm distribution docs](https://github.com/raeseoklee/mcp-workbench/blob/develop/docs/npm-distribution.md) for details.

## Usage

```bash
# Inspect a server
mcp-workbench inspect --command node --args "path/to/server.js"

# Run a test suite
mcp-workbench run tests.yaml --verbose

# JSON output for CI
mcp-workbench run tests.yaml --json
```

## Features

- **`mcp-workbench inspect`** — connect to any MCP server and explore capabilities, tools, resources, and prompts
- **`mcp-workbench run`** — execute YAML-defined test suites with rich assertions
- **Assertion engine** — `status`, `jsonpath`, `executionError`, `protocolError`, `contentType`, `count`, `equals`, `schema`, `snapshot`, and more
- **Transport support** — `stdio`, `streamable-http`, legacy SSE
- **Client simulator** — inject roots, sampling presets, and elicitation handlers
- **CI-friendly** — `--json` output, non-zero exit on failure, `--bail` flag
- **Plugin system** — extend with reporters (`html`, `junit`) and custom commands

## VS Code Extension

Install the [MCP Workbench VS Code extension](https://marketplace.visualstudio.com/items?itemName=raeseoklee.mcp-workbench-vscode) for integrated testing and inspection.

## Links

- [GitHub](https://github.com/raeseoklee/mcp-workbench)
- [Full documentation](https://github.com/raeseoklee/mcp-workbench#readme)
- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=raeseoklee.mcp-workbench-vscode)

## License

[Apache-2.0](https://github.com/raeseoklee/mcp-workbench/blob/develop/LICENSE)
npm package: @mcp-workbench/demo-mcp
Description: Demo MCP server for MCP Workbench — tools, resources, and prompts out of the box
Latest version: 0.2.0

# @mcp-workbench/demo-mcp

A ready-to-use demo [MCP](https://modelcontextprotocol.io) server for **[MCP Workbench](https://github.com/raeseoklee/mcp-workbench)**.

Exposes sample tools, resources, and prompts — perfect for trying out MCP Workbench without writing any server code.

## Install

```bash
npm install -g @mcp-workbench/demo-mcp
```

## Usage

```bash
# Start the demo server (stdio transport)
mcp-workbench-demo

# Inspect with MCP Workbench
npm install -g @mcp-workbench/cli
mcp-workbench inspect --command mcp-workbench-demo

# Run the example test suite
mcp-workbench run examples/fixtures/demo-mcp.yaml --verbose
```

## What's included

| Capability | Examples |
|------------|----------|
| **Tools** | `get_weather` — returns weather for a city |
| **Resources** | Note resources with text content |
| **Prompts** | Greeting prompt with customizable name |

## Built with

- [@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk)
- MCP spec version `2025-11-25`

## Links

- [MCP Workbench](https://github.com/raeseoklee/mcp-workbench) — the testing platform
- [Example test specs](https://github.com/raeseoklee/mcp-workbench/tree/develop/examples/fixtures)

## License

[Apache-2.0](https://github.com/raeseoklee/mcp-workbench/blob/develop/LICENSE)