API Health Check MCP Server

This Model Context Protocol (MCP) server provides tools to check the health status of API endpoints. Specifically designed to monitor the GET localhost:8080/api/ticket endpoint.

Features

• Health Check Tool: Checks if the API endpoint is up or down

• Response Time Monitoring: Measures and reports API response times

• Error Handling: Provides detailed error information when the API is unreachable

• Timeout Protection: Automatically times out requests after 10 seconds

• Formatted Output: Returns easy-to-read status reports with icons and timestamps

Installation

1. Clone this repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage

With Claude Desktop

Add this server to your Claude Desktop configuration:

Development

• npm run build - Build the TypeScript source

• npm run watch - Watch for changes and rebuild automatically

• npm start - Run the compiled server

Tools Available

check_api_health

Checks the health of the GET localhost:8080/api/ticket endpoint.

Parameters: None

Returns:

• API status (up/down)

• Response time in milliseconds

• HTTP status code (if successful)

• Error details (if failed)

• Timestamp of the check

Example Output:

Error Handling

The server handles various error conditions:

• Connection Refused: When the target server is not running

• Timeout: When requests take longer than 10 seconds

• Host Not Found: When localhost cannot be resolved

• HTTP Errors: When the server returns non-200 status codes

Development

This server is built using:

• Model Context Protocol SDK

• TypeScript

• Node.js Fetch API