Tester MCP

测试员mcp

轻量级MCP测试服务器（FastMCP）用于验证和演示MCP客户端集成。 该项目公开了一组简单的MCP工具，可帮助您测试连接、配置、， 以及MCP兼容客户端中的请求/响应流。

不需要外部第三方API。

安装

您有三个选择：

• 安装预构建的操作系统本机二进制文件（建议大多数用户使用）
• 将其用作Gemini CLI扩展
• 使用Node/Bun在本地运行

选项1——预构建的操作系统本机二进制文件（版本）

我们在发布页面上发布适用于macOS、Linux（Ubuntu）和Windows的可移植二进制文件：

发布：https://github.com/xSAVIKx/tester-mcp/releases

选择最新版本并下载适用于您操作系统的二进制文件。文件名由CI在 pre-release 步骤并遵循以下模式：

• macOS： tester-mcp-macos-
• Linux（Ubuntu）： tester-mcp-ubuntu-
• 窗户： tester-mcp-windows-

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

笔记：

• 在Windows上，我们将文件另存为 tester-mcp.exe 为了方便；上游资产名称可能不包括 .exe 扩展。
• 二进制文件会立即通过stdio启动MCP服务器。

选项2——作为Gemini CLI扩展安装

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

这将使用扩展的捆绑CLI入口点配置本地MCP服务器。

选项3——使用Node或Bun在本地运行

如果你想直接从这个仓库运行它（或者在从npm安装后），你可以：

# 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

注意：CLI会立即通过stdio启动MCP服务器。

配置

服务器支持一个可选的环境变量，该变量可以由工具回显 出于测试目的：

• TESTER_ENV_VALUE （可选）：服务器工具可能包含的用户提供的值

响应，以便您可以从客户端确认环境传播。

这些设置也显示在 gemini-extension.json 为了方便起见。

此服务器的功能

• 为MCP客户端提供简单的测试工具/资源（例如echo、基本验证）。
• 帮助验证您的客户端是否能够通过stdio启动MCP服务器并交换消息。
• 使用FastMCP提供最小的依赖性轻参考实现。

项目脚本

开发过程中有用的命令：

# 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

存储库元数据

• 姓名： tester-mcp
• 说明：MCP测试服务器
• 主页：https://github.com/xSAVIKx/tester-mcp
• 许可证：麻省理工学院

贡献

请看 贡献.md 关于贡献指南。

许可证

麻省理工学院