ip2location/mcp-ip2location-io
Free使用 IP2Location.io API 获取 IP 地址地理位置和网络信息。
FreeFree tier
About ip2location/mcp-ip2location-io
IP2Location.io MCP server is a Model Context Protocol (MCP) implementation that provides detailed geolocation information for any IPv4 or IPv6 address using the IP2Location.io API. It supports comprehensive location data (country, region, city, latitude, longitude, ZIP code, time zone), network details (ASN, ISP, domain, network speed), and security insights (proxy type and provider). Built as a FastMCP tool with async HTTP requests via httpx, the server can be used either as a cloud-hosted service or run locally. It offers a free tier without an API key (1,000 queries per day) and a free API key upgrade for up to 50,000 queries per month.
Key Features
Comprehensive geolocation data: country, region, city, latitude, longitude, ZIP code, time zone, and more
Network details: ASN, ISP, domain, and network speed
Security insights: proxy type and provider detection
Simple integration as a FastMCP tool for Claude Desktop and other MCP clients
Asynchronous HTTP requests via httpx for non-blocking performance
Supports both cloud-hosted and local deployment options
Pros & Cons
Pros
- Free tier available with 1,000 queries per day without an API key
- Free API key upgrade provides up to 50,000 queries per month
- Comprehensive data including location, network, and security details
- Easy setup with Claude Desktop (cloud-hosted or local)
- Open source and extensible (MIT license)
Cons
- Limited to 1,000 queries per day without an API key
- Requires API key for higher query limits and cloud-hosted usage
- Dependent on IP2Location.io service availability and API rate limits
- Primarily designed for MCP clients; may require additional setup for other use cases
Best For
IP address geolocation for web applications and analyticsNetwork infrastructure analysis and troubleshootingSecurity investigations and proxy detectionEnhancing Claude Desktop with IP lookup capabilitiesEnriching data pipelines with location and network metadata
FAQ
Do I need an API key to use this MCP server?
No, you can use it without an API key with a limit of 1,000 queries per day. For higher limits (up to 50,000 queries per month), you can sign up for a free API key on the IP2Location.io dashboard.
How do I set up the IP2Location.io MCP server in Claude Desktop?
You can use either the cloud-hosted version (by adding a configuration with npx and your API key) or run the server locally with uv. Detailed setup steps are provided in the README.
What types of data does the server return?
It returns geolocation data (country, region, city, coordinates, ZIP code, time zone), network information (ASN, ISP, domain, speed), and security insights (proxy type and provider).
Is the MCP server free?
Yes, the server is open source and free. The underlying IP2Location.io API offers a free tier with limited queries, and paid plans are available for higher usage.