sadeghtkd/ping-mcp-server

MCP Ping Server

A server implementation that provides ping functionality to Claude Desktop through MCP (Model Context Protocol). This server allows Claude to perform network connectivity tests and ping operations.

certified by MCPHub

Get it from MCPhub.com:

Features

• ping_host: Ping any host with customizable packet count
• check_connectivity: Quick internet connectivity check using Google's DNS (8.8.8.8)
• Cross-platform support (Windows, Linux, MacOS)
• Asynchronous operation using FastMCP and Starlette
• Server-Sent Events (SSE) for real-time communication

Requirements

• Python 3.12+
• Dependencies (automatically installed through pip):
  • httpx
  • mcp[cli]
  • uvicorn
  • starlette

Installation

1. Clone the repository
2. Install dependencies using pip:

pip install .

Usage

Starting the Server

Run the server using Python:

python main.py [--host HOST] [--port PORT]

Default settings:

• Host: 0.0.0.0 (accessible from any network interface)
• Port: 8080

Claude Desktop Configuration

To use this server with Claude Desktop, add the following configuration to your Claude Desktop's configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "ping": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/sse"
      ]
    }
  }
}

Sample test with Claude desktop :

Available Tools

1. ping_host

   • Purpose: Ping a specified host
   • Parameters:
     • host: Hostname or IP address to ping
     • count: Number of ping packets (1-20, default: 4)

2. check_connectivity

   • Purpose: Check internet connectivity
   • Parameters:
     • host: Target host (default: 8.8.8.8)

Security Note

The server is designed for local use with Claude Desktop. Be cautious when exposing it to public networks.

License

This project is open-source. Feel free to modify and distribute as needed.