tester-mcp
This is a test-only MCP server. You can use it as a playgroup for doing experiments with MCP servers
Open source Open in the app JSON README (API)
About
This is a test-only MCP server. You can use it as a playgroup for doing experiments with MCP servers
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- xsavikx
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.3
- Last push
- 2025-11-07T20:05:06Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
xsavikx/tester-mcp
README
# 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): ```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): ```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): ```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 ```bash 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: ```bash # 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: ```bash # 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 - Name: `tester-mcp` - Description: MCP Tester Server - Homepage: https://github.com/xSAVIKx/tester-mcp - License: MIT ## Contributing Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines. ## License MIT