{
  "markdown": "# tester-mcp\n\nLightweight MCP Test Server (FastMCP) used to validate and demonstrate MCP client integrations.\nThis project exposes a simple set of MCP tools that help you test connectivity, configuration,\nand request/response flows in MCP-compatible clients.\n\nNo external third-party APIs are required.\n\n## Installation\n\nYou have three options:\n- Install a prebuilt OS-native binary (recommended for most users)\n- Use it as a Gemini CLI Extension\n- Run locally with Node/Bun\n\n### Option 1 — Prebuilt OS-native binary (Releases)\n\nWe publish portable binaries for macOS, Linux (Ubuntu), and Windows on the Releases page:\n\nReleases: https://github.com/xSAVIKx/tester-mcp/releases\n\nPick 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:\n- macOS: `tester-mcp-macos-<version>`\n- Linux (Ubuntu): `tester-mcp-ubuntu-<version>`\n- Windows: `tester-mcp-windows-<version>`\n\nmacOS (zsh):\n```zsh\n# 1) Download the latest macOS binary (replace 0.1.0 with the latest version)\nVERSION=0.1.0\ncurl -L -o tester-mcp \"https://github.com/xSAVIKx/tester-mcp/releases/download/v$VERSION/tester-mcp-macos-$VERSION\"\nchmod +x tester-mcp\n\n# 2) Run\n./tester-mcp\n```\n\nLinux (bash):\n```bash\n# 1) Download the latest Linux binary (replace 0.1.0 with the latest version)\nVERSION=0.1.0\ncurl -L -o tester-mcp \"https://github.com/xSAVIKx/tester-mcp/releases/download/v$VERSION/tester-mcp-ubuntu-$VERSION\"\nchmod +x tester-mcp\n\n# 2) Run\n./tester-mcp\n```\n\nWindows (PowerShell):\n```powershell\n# 1) Download the latest Windows binary (replace 0.1.0 with the latest version)\n$version = \"0.1.0\"\n$asset   = \"tester-mcp-windows-$version\"\n$uri     = \"https://github.com/xSAVIKx/tester-mcp/releases/download/v$version/$asset\"\nInvoke-WebRequest -Uri $uri -OutFile \"tester-mcp.exe\"\n\n# 2) Run\n./tester-mcp.exe\n```\n\nNotes:\n- On Windows we save the file as `tester-mcp.exe` for convenience; the upstream asset name may not include the `.exe` extension.\n- The binary starts an MCP server over stdio immediately.\n\n### Option 2 — Install as a Gemini CLI Extension\n\n```bash\ngemini extensions install https://github.com/xSAVIKx/tester-mcp\n```\n\nThis will configure a local MCP server using the extension's bundled CLI entrypoint.\n\n### Option 3 — Run locally with Node or Bun\n\nIf you want to run it directly from this repository (or after installing from npm), you can:\n\n```bash\n# Using Node (from built files)\nnode dist/tester-mcp-cli.js\n\n# Or using Bun (from built files)\nbun dist/tester-mcp-cli.js\n\n# For development (TypeScript entrypoint)\nbun src/cli.ts\n```\n\nNote: The CLI starts an MCP server over stdio immediately.\n\n## Configuration\n\nThe server supports a single optional environment variable that can be echoed back by the tools\nfor testing purposes:\n\n- `TESTER_ENV_VALUE` (optional): A user-provided value that the server tools may include in their\n  responses so you can confirm environment propagation from your client.\n\nThese settings are also surfaced in `gemini-extension.json` for convenience.\n\n## What this server does\n\n- Exposes simple test tools/resources for MCP clients (e.g., echo, basic validations).\n- Helps verify your client's ability to start an MCP server over stdio and exchange messages.\n- Provides a minimal, dependency-light reference implementation using FastMCP.\n\n## Project scripts\n\nUseful commands during development:\n\n```bash\n# Build the project to ./dist\nbun run build\n\n# Watch and rebuild during development\nbun run dev\n\n# Type-check\nbun run type-check\n\n# Lint\nbun run lint\n```\n\n## Repository metadata\n\n- Name: `tester-mcp`\n- Description: MCP Tester Server\n- Homepage: https://github.com/xSAVIKx/tester-mcp\n- License: MIT\n\n## Contributing\n\nPlease see [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines.\n\n## License\n\nMIT\n",
  "bytes": 3801,
  "sha": "bac590f33dbd5e4a0c5db6e11b95bc5bc03ddff858e7ba7ba33e0fdbb9d68572",
  "repo_slug": "xsavikx/tester-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_xsavikx_tester_mcp_64780e65/readme"
}