返回 MCP 目录
public公开dns本地运行

MCP-server-tester

一个用于测试MCP服务器连接状态的工具,提供简洁的界面和详细的连接诊断信息。

article

README

🚀 MCP 服务器测试器 🔌

MCP 服务器测试器是一款用于测试 MCP 服务器的工具。它采用极简架构,具备即时视觉反馈和详细的 HTTP 状态报告等功能,能帮助用户快速检测 MCP 服务器的连接状态。

🚀 快速开始

首先,克隆项目仓库到本地:

git clone https://github.com/harshaagrawal20/MCP-server-tester.git

接着,进入项目目录:

cd MCP-server-tester

然后,安装所需的依赖:

npm install express cors body-parser axios

最后,启动服务器:

node server.js

启动成功后,你可以通过访问 http://localhost:5000 来使用该工具。

✨ 主要特性

极简架构

  • 单一端点 (/test-mcp) 带分层验证,确保验证逻辑清晰且高效。
  • 客户端与服务器分离,客户端代码存于 public/ 目录,服务器代码为 server.js,便于维护和扩展。
  • 无状态操作,不依赖数据库,减少了系统的复杂度和维护成本。

验证管道

前端输入经过一系列处理:清理输入(移除反斜杠和空白字符)、验证 URL 结构、测试实际连接(带 5s 超时设置),最后返回诊断信息,保证了输入的有效性和连接测试的准确性。

核心功能

  • 即时视觉反馈,通过不同的状态显示(成功/错误状态),让用户快速了解测试结果。
  • 采用硬件加速 CSS 动画,提升用户体验。
  • 响应式玻璃摩尔主义设计,界面美观且适配不同设备。
  • 提供详细的 HTTP 状态报告,方便用户深入了解服务器状态。

💻 使用示例

API 使用说明

/test-mcp 发送 POST 请求,请求体格式如下:

{"serverConfig": {"url": "https://example.com"}}

服务器响应格式如下:

{"success": true|false, "message": "状态详情"}

📚 详细文档

视频演示

你可以通过 观看演示 来了解该工具的使用方法。

实时演示

你可以访问 部署版本 进行实时测试。

🔧 技术细节

技术栈

| 属性 | 详情 | |------|------| | 前端 | HTML5、CSS3、ES6 | | 后端 | Node.js、Express | | HTTP 客户端 | Axios | | UI 框架 | 玻璃摩尔主义 CSS |

配置

你可以通过修改以下配置来调整工具的行为:

const PORT = 5000; // 修改端口
const TIMEOUT = 5000;    // 调整超时时间

截图

成功 错误

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端