tester-mcp

xSAVIKx/tester-mcp

3.1

If you are the rightful owner of tester-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Lightweight MCP Test Server (FastMCP) used to validate and demonstrate MCP client integrations.

tester-mcp

Lightweight MCP Test Server (FastMCP) used to validate and demonstrate MCP client integrations. This project exposes a simple set of MCP tools that help you test connectivity, configuration, and request/response flows in MCP-compatible clients.

No external third-party APIs are required.

Installation

You have three options:

  • Install a prebuilt OS-native binary (recommended for most users)
  • Use it as a Gemini CLI Extension
  • Run locally with Node/Bun

Option 1 — Prebuilt OS-native binary (Releases)

We publish portable binaries for macOS, Linux (Ubuntu), and Windows on the Releases page:

Releases: https://github.com/xSAVIKx/tester-mcp/releases

Pick the latest release and download the binary for your OS. File names are produced by CI in the pre-release step and follow this pattern:

  • macOS: tester-mcp-macos-<version>
  • Linux (Ubuntu): tester-mcp-ubuntu-<version>
  • Windows: tester-mcp-windows-<version>

macOS (zsh):

# 1) Download the latest macOS binary (replace 0.1.0 with the latest version)
VERSION=0.1.0
curl -L -o tester-mcp "https://github.com/xSAVIKx/tester-mcp/releases/download/v$VERSION/tester-mcp-macos-$VERSION"
chmod +x tester-mcp

# 2) Run
./tester-mcp

Linux (bash):

# 1) Download the latest Linux binary (replace 0.1.0 with the latest version)
VERSION=0.1.0
curl -L -o tester-mcp "https://github.com/xSAVIKx/tester-mcp/releases/download/v$VERSION/tester-mcp-ubuntu-$VERSION"
chmod +x tester-mcp

# 2) Run
./tester-mcp

Windows (PowerShell):

# 1) Download the latest Windows binary (replace 0.1.0 with the latest version)
$version = "0.1.0"
$asset   = "tester-mcp-windows-$version"
$uri     = "https://github.com/xSAVIKx/tester-mcp/releases/download/v$version/$asset"
Invoke-WebRequest -Uri $uri -OutFile "tester-mcp.exe"

# 2) Run
./tester-mcp.exe

Notes:

  • On Windows we save the file as tester-mcp.exe for convenience; the upstream asset name may not include the .exe extension.
  • The binary starts an MCP server over stdio immediately.

Option 2 — Install as a Gemini CLI Extension

gemini extensions install https://github.com/xSAVIKx/tester-mcp

This will configure a local MCP server using the extension's bundled CLI entrypoint.

Option 3 — Run locally with Node or Bun

If you want to run it directly from this repository (or after installing from npm), you can:

# Using Node (from built files)
node dist/tester-mcp-cli.js

# Or using Bun (from built files)
bun dist/tester-mcp-cli.js

# For development (TypeScript entrypoint)
bun src/cli.ts

Note: The CLI starts an MCP server over stdio immediately.

Configuration

The server supports a single optional environment variable that can be echoed back by the tools for testing purposes:

  • TESTER_ENV_VALUE (optional): A user-provided value that the server tools may include in their responses so you can confirm environment propagation from your client.

These settings are also surfaced in gemini-extension.json for convenience.

What this server does

  • Exposes simple test tools/resources for MCP clients (e.g., echo, basic validations).
  • Helps verify your client's ability to start an MCP server over stdio and exchange messages.
  • Provides a minimal, dependency-light reference implementation using FastMCP.

Project scripts

Useful commands during development:

# Build the project to ./dist
bun run build

# Watch and rebuild during development
bun run dev

# Type-check
bun run type-check

# Lint
bun run lint

Repository metadata

Contributing

Please see for contribution guidelines.

License

MIT