Project Setup Guide

Project Setup Guide

site icon
2025.04.04 0
JavaScriptMCP 服务器测试工具其它
mcp-server-tester 是一个用于测试 MCP 服务器可用性的工具,主要功能是通过查询 `https://registry.smithery.ai/servers/{installationCode}` 端点来检查 MCP 服务器的状态。它提供了一个简单的 Node.js Express 端点 `/test-server`,用于接收安装代码并返回服务器的可用性信息。
View on GitHub

Overview

基本能力

产品定位

mcp-server-tester 是一个用于测试 MCP 服务器可用性的工具,适用于开发者和系统管理员,用于验证 MCP 服务器的连接状态和配置。

核心功能

  1. 提供 /test-server 端点,用于检查 MCP 服务器的可用性。
  2. 支持通过 installationCode 查询服务器信息。
  3. 返回服务器的详细数据,包括 qualifiedNamedisplayNamedeploymentUrl 和连接信息。

适用场景

  1. 开发环境中验证 MCP 服务器的连接。
  2. 系统管理员监控 MCP 服务器的状态。
  3. 自动化测试中集成 MCP 服务器可用性检查。

工具列表

  1. Node.js Express:用于构建后端服务器和提供 API 端点。
  2. npm:用于管理依赖和运行脚本。

常见问题解答

  1. 如何解决连接失败的问题?
  2. 确保提供的 installationCode 正确。
  3. 检查网络连接是否正常。
  4. 验证 https://registry.smithery.ai/servers/{installationCode} 端点是否可访问。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 安装项目依赖: bash npm install

安装教程

  1. 克隆项目并进入项目目录。
  2. 安装后端依赖: bash cd backend npm install
  3. 创建 .env 文件并配置环境变量: env PORT=5000 FRONTEND_URL=http://localhost:5173
  4. 启动后端服务器: bash npm run dev
  5. 安装前端依赖: bash cd frontend npm install
  6. 创建 .env 文件并配置环境变量: env VITE_BACKEND_URL=http://localhost:5000
  7. 启动前端客户端: bash npm run dev

调试方式

  1. 确保后端和前端服务器同时运行。
  2. 访问 http://localhost:5173 测试完整应用。
  3. 使用 /test-server 端点测试 MCP 服务器可用性: bash curl -X POST http://localhost:5000/test-server -H "Content-Type: application/json" -d '{"installationCode":"your-installation-code"}'

许可证

None