Ip Region And Ping A Test Mcp

by ipconfig-com

242 downloads
Not rated
GitHub

About

A powerful IPCONFIG MCP (Model Context Protocol) server built on Cloudflare Workers, providing IP address lookup, geolocation, and network connectivity testing tools for AI assistants.

Details

Author
ipconfig-com
Downloads
242
Categories
Developer Tools

- IP address lookup for the current client
- Detailed geolocation for any IP address
- Ping connectivity test from multiple global locations
- CORS support for cross-origin access
- High performance via Cloudflare Workers edge platform
- Standard MCP protocol compliance

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 Ip Region And Ping A Test Mcp
    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

Configure your MCP client (Cursor IDE or Claude Desktop) by adding a JSON entry with command: "npx", args: ["mcp-remote", "https://mcp.ipconfig.com/mcp"], and setting the IPCONFIG_API_KEY environment variable. For self-hosting, clone the repository, install dependencies, set the API key via wrangler secret, and deploy to Cloudflare Workers using npm run deploy. Test connectivity with curl https://mcp.ipconfig.com/health.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "ip region and ping a test mcp": {
            "ipconfig": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://mcp.ipconfig.com/mcp"
                ],
                "env": {
                    "IPCONFIG_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

McpServers

{
    "ipconfig": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://mcp.ipconfig.com/mcp"
        ],
        "env": {
            "IPCONFIG_API_KEY": "your-api-key-here"
        }
    }
}

IPCONFIG MCP Server

中文文档 | English A powerful IPCONFIG MCP (Model Context Protocol) server built on Cloudflare Workers, providing IP address lookup, geolocation, and network connectivity testing tools for AI assistants.

🌟 Features

- IP Address Lookup - Get current client's public IP address - IP Geolocation - Detailed geographic location information for any IP address - Ping Connectivity Test - Test network connectivity and latency to any host - CORS Support - Full CORS support, accessible from any domain - High Performance - Built on Cloudflare Workers edge computing platform - Standard Protocol - Fully compatible with MCP protocol specifications

🔑 Getting Your API Key

Before configuring any MCP client, you need to obtain an API key from IPCONFIG:

Step-by-Step Guide

1. Create Account - Visit IPCONFIG Console - Sign up for a free account or log in if you already have one 2. Access API Keys Management - Navigate to the API Keys page in your console - You'll see your API key management dashboard 3. Create New API Key - Click the "Create New Key" button - Enter a recognizable name for your API key (e.g., "MCP Client", "Claude Desktop") - Click "Create" 4. Save Your Key - ⚠️ Critical: Copy your API key immediately and store it securely - The key will only be displayed once for security reasons - If you lose it, you'll need to create a new one

API Key Features

| Feature | Free Tier | Pro Tier | |---------|-----------|----------| | Rate Limit | 60 requests/min | 100 requests/sec | | Monthly Credits | 1,000 | 10,000+ | | Get My IP | ✅ Free | ✅ Free | | IP Location | 1 credit/query | 1 credit/query | | Ping Test | 1 credit/node | 1 credit/node | For more details, visit the API Key Management documentation.

🚀 Quick Start

For Users

Cursor IDE Configuration (Recommended)

One-Click Install: <a target="_blank" rel="noopener noreferrer" href="cursor://anysphere.cursor-deeplink/mcp/install?name=ipconfig&config=eyJjb21tYW5kIjogIm5weCIsICJhcmdzIjogWyJtY3AtcmVtb3RlIiwgImh0dHBzOi8vbWNwLmlwY29uZmlnLmNvbS9tY3AiXSwgImVudiI6IHsiSVBDT05GSUdfQVBJX0tFWSI6ICJ5b3VyLWFwaS1rZXktaGVyZSIsICJMQU5HVUFHRSI6ICJlbiJ9fQ=="> One-Click Install to Cursor </a> Manual Configuration: - macOS: ~/Library/Application Support/Cursor/mcp.json - Windows: %APPDATA%\Cursor\mcp.json - Linux: ~/.config/Cursor/mcp.json ``json { "mcpServers": { "ipconfig": { "command": "npx", "args": ["mcp-remote", "https://mcp.ipconfig.com/mcp"], "env": { "IPCONFIG_API_KEY": "your-api-key-here" } } } } `

Claude Desktop Configuration

1. Get API Key: Follow the API Key guide above to obtain your API key 2. Configure Claude Desktop: - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json 3. Add Configuration: `json { "mcpServers": { "ipconfig": { "command": "npx", "args": ["mcp-remote", "https://mcp.ipconfig.com/mcp"], "env": { "IPCONFIG_API_KEY": "your-api-key-here" } } } } ` 4. Restart Claude Desktop and test: "What's my IP address?"

For Developers

1. Clone Repository

`bash git clone https://github.com/your-username/ipconfig-mcp.git cd ipconfig-mcp `

2. Install Dependencies

`bash npm install `

3. Configure Environment

``bash
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.