standardbeagle/mcp-tui

这是什么？

核心功能

• 01在 TUI 中根据工具的输入 schema 自动生成调用表单。
• 02CLI 支持同样的调用，输出 JSON 便于配合 jq 使用。
• 03连接失败时给出具体原因和修复建议。
• 04记录所有 JSON-RPC 消息、HTTP 耗时和 OAuth 流程步骤。
• 05可将 TUI 会话导出为可重放的 shell 脚本。
• 06生成 JUnit 一致性测试报告，便于接入 CI。

适用场景

• 在把新的 MCP 服务器接入 AI 客户端前，手动测试其工具。
• 排查 MCP 服务器通过 HTTP 或 stdio 无法连接的问题。
• 在 CI 流水线中加入 MCP 服务器的一致性检查。
• 在 shell 中编写可重复执行的 MCP 工具调用脚本。

快速上手

1. 1

   使用 Go 安装

   go install github.com/standardbeagle/mcp-tui@latest
2. 2

   或使用 npm 安装

   npm install -g @standardbeagle/mcp-tui
3. 3

   连接 HTTP MCP 服务器并打开 TUI

   mcp-tui --url http://localhost:8080/mcp

使用前须知

• !这是一个早期项目，仅有 12 个星标，采用情况和长期记录有限。

标签

常见问题

mcp-tui 是什么？

用于测试、调试和自动化 MCP 服务器的终端 UI 与命令行工具，支持 stdio、SSE 和 HTTP。 mcp-tui 让你在终端中连接 Model Context Protocol 服务器，选择工具，通过根据输入 schema 自动生成的表单填写参数并执行调用。每次调用都可以导出为等价的 CLI 命令，便于把手动测试迁移到 shell 脚本或 CI 流程中。

mcp-tui 可以免费使用吗？用的什么许可证？

mcp-tui 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

mcp-tui 还在维护吗？

活跃维护中。mcp-tui 最近一次提交是在 2026年10月18日。

mcp-tui 适合用来做什么？

在把新的 MCP 服务器接入 AI 客户端前，手动测试其工具。 排查 MCP 服务器通过 HTTP 或 stdio 无法连接的问题。 在 CI 流水线中加入 MCP 服务器的一致性检查。 在 shell 中编写可重复执行的 MCP 工具调用脚本。

mcp-tui 怎么安装和运行？

使用 Go 安装: go install github.com/standardbeagle/mcp-tui@latest 或使用 npm 安装: npm install -g @standardbeagle/mcp-tui 连接 HTTP MCP 服务器并打开 TUI: mcp-tui --url http://localhost:8080/mcp

在哪里获取 mcp-tui？

源代码和安装说明在 GitHub 上：https://github.com/standardbeagle/mcp-tui