๐ mcp-ip-geo
About
An MCP Server that provides IP geolocation lookup (country, region, city, etc.) via ip-api.com.
Details
- Author
- chenmingyong0423
- GitHub stars
- 13
- Downloads
- 311
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
๐ mcp-ip-geoCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\udcdd mcp-ip-geo": {
"mcp-ip-geo": {
"command": "/path/to/mcp-ip-geo"
}
}
}
}McpServers
{
"mcp-ip-geo": {
"command": "/path/to/mcp-ip-geo"
}
}<h1 align="center">
๐ mcp-ip-geo
</h1>
<div align="center">
English | <a href="./README-zh_CN.md">็ฎไฝไธญๆ</a>
</div>
---
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/
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
