mcp-ip
About
Get geographic location information from IP addresses using offline IP database.
Details
- Author
- qiangmzsx
- Downloads
- 322
- Categories
- Other, Database
Jump to
- 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.
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-ipCommand (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
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-ip": {
"ipinfo": {
"command": "mcp-ip",
"args": [
"-transport",
"stdio",
"-xdb_path",
"./data/ip2region.xdb"
]
}
}
}
}McpServers
{
"ipinfo": {
"command": "mcp-ip",
"args": [
"-transport",
"stdio",
"-xdb_path",
"./data/ip2region.xdb"
]
}
}mcp-ip
Get geographic location information from IP addresses using offline IP database.IP Database Support
Currently using ip2region database: https://github.com/lionsoul2014/ip2region.Usage
Build
$ git clone https://github.com/qiangmzsx/mcp-ip.git
$ cd mcp-ip
$ go build -o mcp-ip
stdio
{
"mcpServers": {
"ipinfo": {
"command": "mcp-ip",
"args": [
"-transport",
"stdio",
"-xdb_path",
"/data/ip2region.xdb"
]
}
}
}
-xdb_path whenever possible.
http
$ ./mcp-ip -transport streamable_http -port 8080 -xdb_path /data/ip2region.xdb
$ http://127.0.0.1:8080/mcp
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
