mcp-ip

What is mcp-ip?

mcp-ip is an MCP server that retrieves geographic location information from IP addresses using the offline ip2region database. It is intended for users who need IP geolocation without external API calls.

How to use mcp-ip?

Build from source with go build -o mcp-ip, then run via stdio or HTTP transport. For stdio, configure in mcpServers with the command mcp-ip and arguments -transport stdio -xdb_path <path>. For HTTP, run ./mcp-ip -transport streamable_http -port 8080 -xdb_path /data/ip2region.xdb and access at http://127.0.0.1:8080/mcp.

Key features of mcp-ip

• Offline IP geolocation using the ip2region database.
• Supports both stdio and streamable HTTP transports.
• Written in Go; single binary after build.
• Requires an ip2region .xdb database file.
• Lightweight and self-contained.

Use cases of mcp-ip

• Adding IP location context to AI prompts in MCP-compatible clients.
• Geotagging network logs or user requests locally.
• Building privacy‑friendly tools that avoid external geolocation APIs.

FAQ from mcp-ip

What IP database does mcp-ip use?

It uses the offline ip2region database from https://github.com/lionsoul2014/ip2region.

How do I specify the database file?

Pass the -xdb_path argument with the path to the ip2region.xdb file. An absolute path is recommended.

What transports does mcp-ip support?

It supports stdio and streamable_http (HTTP) transports, configured via the -transport flag.

Does mcp-ip require a network connection?

No. The geolocation data is stored in the local .xdb file, so no outbound connections are needed.

How do I build mcp-ip from source?

Clone the repository, run go build -o mcp-ip in the project directory, then use the resulting binary.