mcpField
📝
📝 mcp-ip-geo

📝 mcp-ip-geo

Local
github.com/chenmingyong0423Maps & Travel13Updated 74w ago
Repository

About 📝 mcp-ip-geo

mcp-ip-geo is an MCP server that uses ip-api.com to look up IP geolocation, including country, region, and city. It can run through Go over Stdio or be deployed with Docker using Streamable HTTP.

Key features

  1. 01Looks up IP geolocation via ip-api.com
  2. 02Returns country, region, and city details
  3. 03Runs through the Go command
  4. 04Supports Docker deployment
  5. 05Offers Stdio and Streamable HTTP access

Use cases

  1. 01Find the country and city for an IP
  2. 02Retrieve IP geolocation from an MCP client
  3. 03Deploy a remote MCP server with Docker

MCP support

The MCP server provides IP geolocation lookup to clients over Stdio or Streamable HTTP. Lookups use ip-api.com.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

📝 mcp-ip-geo

English | 简体中文

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/

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.