MCP Server Tester logo

MCP Server Tester

by harshaagrawal20

MCP Server Tester is a minimalist Node.js application designed to test the connectivity of MCP servers. It provides instant visual feedback and detailed HTTP status reporting.

View on GitHub

Last updated: N/A

MCP Server Tester 🔌

Node.js

Node.js

Express

Express

Glassmorphism

Glassmorphism

Technical Approach 🛠️

1. Minimalist Architecture

  • Single endpoint (/test-mcp) with layered validation
  • Client-server separation (public/ vs server.js)
  • Stateless operation (no database)

2. Validation Pipeline

Frontend → Sanitize Input → Validate URL → Test Connection → Return Diagnostics

  • Removes backslashes/whitespace
  • Verifies URL structure
  • Tests actual connection with 5s timeout

3. Key Features

  • Instant visual feedback (success/error states)
  • Hardware-accelerated CSS animations
  • Responsive glassmorphism design
  • Detailed HTTP status reporting

Quick Start 🚀

git clone https://github.com/harshaagrawal20/MCP-server-tester.git cd MCP-server-tester npm install express cors body-parser axios node server.js

Access: http://localhost:5000

Video Demo

Watch Demo

Live Demo 🌐

View Deployed Version

API Usage

POST /test-mcp {"serverConfig": {"url": "https://example.com"}}

Response: {"success": true|false, "message": "Status details"}

Tech Stack 💻

| Component | Technology | |----------------|------------------| | Frontend | HTML5, CSS3, ES6 | | Backend | Node.js, Express | | HTTP Client | Axios | | UI Framework | Glassmorphism CSS|

Configuration

const PORT = 5000; // Change port

const TIMEOUT = 5000; // Adjust timeout

Screenshots

Success

Success

Error

Error