MCP Ping Server

by sadeghtkd

349 downloads
Not rated
GitHub

About

This mcp server allows Claude to perform network connectivity tests and ping operations.

Details

Author
sadeghtkd
Downloads
349
Categories
Other

- Provides ping_host and check_connectivity tools
- Cross-platform support (Windows, Linux, MacOS)
- Asynchronous operation using FastMCP and Starlette
- Real‑time communication via Server‑Sent Events (SSE)
- Customizable packet count (1–20, default 4)
- Default internet connectivity check against Google DNS (8.8.8.8)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Ping Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with pip install . after cloning the repository. Start the server by running python main.py with optional --host and --port arguments (defaults: 0.0.0.0, port 8080). Then configure Claude Desktop by adding the provided JSON snippet to its claude_desktop_config.json, pointing to the server’s SSE endpoint.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp ping server": {
            "ping-mcp-server": {
                "command": "python",
                "args": [
                    "main.py",
                    "[--host",
                    "HOST]",
                    "[--port",
                    "PORT]"
                ]
            }
        }
    }
}

McpServers

{
    "ping-mcp-server": {
        "command": "python",
        "args": [
            "main.py",
            "[--host",
            "HOST]",
            "[--port",
            "PORT]"
        ]
    }
}

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.

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 :

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.