📝 mcp-ip-geo

@chenmingyong0423

About 📝 mcp-ip-geo

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

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.

What MCP transports are supported?

It supports Stdio transport (using the go run command) and Streamable HTTP transport (via the Docker deployment on port 8000).

Where does the geolocation data come from?

All location data is fetched live from the ip-api.com service at query time. The server does not store or cache IP data locally.

Frequently asked questions

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.

What MCP transports are supported?

It supports Stdio transport (using the `go run` command) and Streamable HTTP transport (via the Docker deployment on port 8000).

Where does the geolocation data come from?

All location data is fetched live from the ip-api.com service at query time. The server does not store or cache IP data locally.

Comments

Basic information

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Website

FunnyWolf

Adversary simulation and Red teaming platform with AI

5.1K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K