mcp-ip-geo

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

Building from Source

Build Locally

Using Go Command

# On Unix-based systems (Linux/macOS)
go build -o mcp-ip-geo ./cmd/mcp-ip-geo

# On Windows
go build -o mcp-ip-geo.exe .cmdmcp-ip-geo

Using Docker

1. Build the Docker image:

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

2. Run the Docker container:

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

Install Prebuilt Binary

Install the server using Go:

go install github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest

MCP Integration

You can integrate mcp-ip-geo in one of the following ways:

🖥 Executable Integration (run a local binary)

{
  "mcpServers": {
    "mcp-ip-geo": {
      "command": "/path/to/mcp-ip-geo"
    }
  }
}

🌐 HTTP Integration (connect to a running instance via HTTP)

{
  "mcpServers": {
    "mcp-ip-geo": {
      "url": "http://host:port/sse"
    }
  }
}

License

⚠ Notice: This project uses the free version of ip-api.com, which is strictly limited to non-commercial use. If you intend to use this project for commercial purposes, please make sure to comply with their terms of service or purchase a commercial license: ip-api.com