AI导哈

MCP服务器烟雾测试工具

一款用于通过真实英文请求对MCP服务器进行烟雾测试的CLI工具，适用于端到端测试基础设施。

  • by tavric-labs
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Agent-Hellboy/mcp-smoke

使用说明

mcp烟雾

mcp-smoke-agent 是一个小型CLI，用于通过真正的简单英语请求对MCP服务器进行烟雾测试。

为什么在e2e线束中使用它

如果您正在构建MCP服务器基础架构，这将为您提供一个用于端到端测试的现实客户端。

您可以通过CLI发送一个简单的英文请求，让它调用真正的MCP工具路径，并验证周围的基础设施行为，而不是为每种情况手写原始MCP请求。这对于检查路由、身份验证、日志记录、跟踪以及是否为真实的工具调用流正确生成分析非常有用。

安装

go install github.com/Agent-Hellboy/mcp-smoke/cmd/mcp-smoke-agent@latest

快速开始

cat > .env <<'EOF'
OPENAI_API_KEY=your-key-here
EOF

go run ./cmd/mcp-smoke-agent \
  --server "go run ./cmd/mcp-test-server" \
  "add 41 and 1"

用法

默认模式：

mcp-smoke-agent [flags] [plain English request]

此模式连接到MCP服务器，列出其工具，并让OpenAI或Anthropic模型决定从请求中调用哪个MCP工具。

有用的模式：

  • 将请求作为尾随文本传递。
  • 使用 --prompt "..." 只需一次通话。
  • 管道标准用于一次性使用。
  • 省略使用交互模式的提示。

--server 接受：

  • HTTP URL类似 http://localhost:3000/mcp
  • stdio命令字符串，如 go run ./cmd/mcp-test-server
  • JSON数组命令，如 ["go","run","./cmd/mcp-test-server"]

CLI从shell环境中读取提供程序配置，或 .env:

  • OPENAI_API_KEY 或 ANTHROPIC_API_KEY
  • OPENAI_MODEL 或 ANTHROPIC_MODEL

默认型号为 gpt-4.1-mini 对于OpenAI和 claude-3-5-haiku-latest 对于Anthropic来说。

低烟模式

如果你想在没有LLM的情况下进行原始MCP协议检查，请使用：

mcp-smoke-agent smoke [flags]

示例：

mcp-smoke-agent smoke --transport=http --url http://localhost:3000/mcp
mcp-smoke-agent smoke --transport=stdio --command ./your-mcp-server -- <args>

此模式初始化MCP，列出功能，并可以选择直接调用工具、提示或资源。

相关 MCP