mcp-ip-geo

mcp-ip-geo is an MCP server that provides IP geolocation information (country, region, city, etc.) by querying the ip-api.com service. It integrates with your MCP workflow and can be run either directly from source using Go or via Docker. When deployed, clients can send IP lookup requests through the MCP interface and receive geolocation data in response. The server is designed to be easy to drop into an existing MCP setup and to work with standard MCP request/response semantics.

To use the Go-based method, configure your MCP to start the server with the provided command. The service exposes an HTTP-based interaction at the configured /mcp endpoint, which the MCP framework will invoke to resolve geolocation details for given IPs. If you prefer containerized deployment, you can build and run a Docker image and then point your MCP configuration to the container's address and port. The Docker method is especially convenient for deployment in environments where you manage services as containers.

Prerequisites:\n- Go (1.20+ recommended) for the Go-run method.\n- Docker for containerized deployment.\n\nInstallation steps (Go-run method):\n1. Ensure Go is installed on your system.\n2. Run the MCP config snippet from the README within your MCP configuration to pull the latest mcp-ip-geo using:\n {\n "mcpServers": {\n "mcp-ip-geo": {\n "command": "go",\n "args": [\n "run",\n "github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest"\n ]\n }\n }\n }\n3. Start your MCP runtime which will invoke the above server.\n\nInstallation steps (Docker method):\n1. Install Docker.\n2. Build the Docker image:\n docker build -t mcp-ip-geo-server .\n3. Run the container:\n docker run -d --name mcp-ip-geo-server -p 8000:8000 mcp-ip-geo-server\n4. In your MCP configuration, point to the server using the URL http://<server-address>:8000/mcp. Replace <server-address> with your deployment address.\n\nNotes: The container exposes 0.0.0.0:8000 inside the container to allow external access.

Tips and caveats:\n- The service uses ip-api.com in its backend. The free tier is for non-commercial use only. If you plan commercial use, review ip-api's terms or upgrade to a paid tier.\n- When running in Docker, ensure the host can reach the container on the mapped port (default 8000).\n- If you experience connectivity issues, verify that the MCP is configured to connect to the correct /mcp endpoint and that any required firewall rules allow access to the port.\n- No mandatory environment variables are specified by the README; you can add env vars if you extend the server (e.g., to configure ip-api access or rate limits) but none are required for basic operation.