📝 mcp-ip-geo

Name: 📝 mcp-ip-geo
Author: chenmingyong0423

@chenmingyong0423

Repository

About 📝 mcp-ip-geo

An MCP Server that provides IP geolocation lookup (country, region, city, etc.) via ip-api.com.

#go #mcp #geolocation #ip #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 📝 mcp-ip-geo?

📝 mcp-ip-geo is an MCP (Model Context Protocol) server that provides IP geolocation lookup services—returning country, region, city, and other location data—using the ip-api.com service. It targets developers who want to add IP geolocation capabilities to MCP-compatible applications.

How to use 📝 mcp-ip-geo?

Two deployment methods are available: run directly with go run github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest via Stdio transport, or build the Docker image and run the container for Streamable HTTP transport on port 8000. Configure the MCP client with the corresponding JSON snippet for your chosen method.

Key features of 📝 mcp-ip-geo

IP geolocation (country, region, city)
Two deployment options: Stdio or Docker HTTP
Powered by ip-api.com’s free tier
Streamable HTTP transport over port 8000
Single-purpose, easy-to-integrate service

Use cases of 📝 mcp-ip-geo

Add IP location data to AI assistant conversations
Enrich user context with geographic information
Validate or analyze IP addresses in automated workflows
Power location-aware features in MCP-based tools

FAQ from 📝 mcp-ip-geo

What data does 📝 mcp-ip-geo return?

It returns country, region, city, and similar geolocation details for a given IP address, using the ip-api.com service.

What runtime or dependencies are required?

You need either Go (to run the go run command) or Docker (to build and run the container image). No external database or configuration files are required.

Is 📝 mcp-ip-geo free for commercial use?

No—the project uses the free version of ip-api.com, which is for non-commercial use only. Commercial users must comply with ip-api.com’s terms or purchase a paid plan.