What is Mcp Ip Geo

mcp-ip-geo is an MCP server that provides IP geolocation lookup, allowing users to retrieve information such as country, region, and city based on IP addresses using the ip-api.com service.

Use cases

Use cases for mcp-ip-geo include personalizing user experiences based on location, analyzing web traffic sources, and enhancing security measures by identifying the geographical origin of IP addresses.

How to use

To use mcp-ip-geo, you can either build it from source using Go or Docker, or install a prebuilt binary. Integration can be done via executable or HTTP methods, depending on your setup.

Key features

Key features of mcp-ip-geo include accurate IP geolocation data retrieval, support for both local binary execution and HTTP integration, and compliance with ip-api.com’s usage policies.

Where to use

mcp-ip-geo can be used in various fields such as web development, analytics, marketing, and any application that requires geolocation data for IP addresses.

📝 mcp-ip-geo

mcp-ip-geo is an MCP (Model Context Protocol) server that provides IP geolocation lookup services (country, region, city, etc.) using the ip-api.com service.

🔌 MCP Integration

You can integrate the mcp-ip-geo service in two ways:

Method 1: Using the go run command (Stdio)

Add the following to your MCP configuration to run the latest version directly from GitHub:

{
  "mcpServers": {
    "mcp-ip-geo": {
      "command": "go",
      "args": [
        "run",
        "github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest"
      ]
    }
  }
}

Method 2: Using Docker (Streamable HTTP)

🐳 Docker Deployment

Step 1: Clone the repository

git clone https://github.com/chenmingyong0423/mcp-ip-geo.git
cd mcp-ip-geo

Step 2: Build the Docker image

docker build -t mcp-ip-geo-server .

Step 3: Run the container

docker run -d --name mcp-ip-geo-server -p 8000:8000 mcp-ip-geo-server

Once running successfully, the service will listen on 0.0.0.0:8000 within the container (listening on all network interfaces), and can be accessed via http://<server-address>:8000/mcp, where <server-address> can be:

• Local development environment: Use localhost or 127.0.0.1
• LAN environment: Use the server’s internal IP address (e.g., 192.168.x.x)
• Public network environment: Use the server’s public IP address or domain name

Note: The service is configured to listen on the 0.0.0.0 address inside the container, which is standard practice for containerized applications, ensuring the service can be accessed from outside the container.

Step 4: Configure MCP

Add the following to your MCP configuration:

{
  "mcpServers": {
    "mcp-ip-geo": {
      "url": "http://<server-address>:8000/mcp"
    }
  }
}

Replace <server-address> with the actual server IP address or domain name of your deployment environment.

⚠️ License Notice

Note: This project uses the free version of ip-api.com, which is for non-commercial use only. If you intend to use this project for commercial purposes, please comply with their terms of service or purchase the paid version: https://ip-api.com/