Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client