{"id":29358353,"url":"https://github.com/ip2location/mcp-ip2location-io","last_synced_at":"2025-08-23T03:34:37.279Z","repository":{"id":301068216,"uuid":"1006754436","full_name":"ip2location/mcp-ip2location-io","owner":"ip2location","description":"IP Geolocation MCP server using IP2Location.io API","archived":false,"fork":false,"pushed_at":"2025-07-16T06:31:43.000Z","size":126,"stargazers_count":8,"open_issues_count":0,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-15T06:55:51.178Z","etag":null,"topics":["claude-desktop","geolocation","geolocation-data","ip","mcp","mcp-server"],"latest_commit_sha":null,"homepage":"https://www.ip2location.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ip2location.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.TXT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-22T23:48:40.000Z","updated_at":"2025-08-01T15:12:19.000Z","dependencies_parsed_at":"2025-07-09T07:00:33.153Z","dependency_job_id":"d4107ec1-b67c-40d2-9f9d-4315d6631446","html_url":"https://github.com/ip2location/mcp-ip2location-io","commit_stats":null,"previous_names":["ip2location/mcp-ip2location-io"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ip2location/mcp-ip2location-io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ip2location%2Fmcp-ip2location-io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ip2location%2Fmcp-ip2location-io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ip2location%2Fmcp-ip2location-io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ip2location%2Fmcp-ip2location-io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ip2location","download_url":"https://codeload.github.com/ip2location/mcp-ip2location-io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ip2location%2Fmcp-ip2location-io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271737826,"owners_count":24812207,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-desktop","geolocation","geolocation-data","ip","mcp","mcp-server"],"created_at":"2025-07-09T07:00:16.068Z","updated_at":"2025-08-23T03:34:37.254Z","avatar_url":"https://github.com/ip2location.png","language":"Python","funding_links":[],"categories":["🗺️ \u003ca name=\"location-services\"\u003e\u003c/a\u003eLocation Services","Official Servers","پیاده‌سازی‌های سرور","📦 Other","MCP 服务器精选列表","Location Services","カテゴリ","Maps \u0026 Location","Server Implementations"],"sub_categories":["🗺️ \u003ca name=\"location-services\"\u003e\u003c/a\u003eخدمات مکانی","🌍 地理位置与出行","How to Submit","🔌 \u003ca name=\"api-development\"\u003e\u003c/a\u003eAPI開発","🗺️ \u003ca name=\"location-services\"\u003e\u003c/a\u003eLocation Services"],"readme":"# IP2Location.io MCP server\n\nThis is a simple Model Context Protocol (MCP) server implementation for IP2Location.io API. It will return a detailed geolocation information for any given IPv4 or IPv6 address.\n\n\u003ca href=\"https://glama.ai/mcp/servers/@ip2location/mcp-ip2location-io\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@ip2location/mcp-ip2location-io/badge\" /\u003e\n\u003c/a\u003e\n\n# Features\n\n- **Comprehensive Geolocation Data**: Retrieves a wide range of information, including country, region, city, latitude, longitude, ZIP code, time zone, and more.\n- **Network Details**: Provides network-related data such as ASN, ISP, domain, and network speed.\n- **Security Insights**: Detects proxy information, including proxy type and provider.\n- **Simple Integration**: Built as a `FastMCP` tool, allowing for easy integration into compatible systems.\n- **Asynchronous**: Utilizes `httpx` for non-blocking asynchronous API requests.\n\n# Requirement\n\nThis MCP server supports to query without an API key, with a limitation of 1,000 queries per day. You can also [sign up](https://www.ip2location.io/sign-up) for a free API key and enjoy up to 50,000 queries per month.\n\nThe setup also use `uv`, which can be install by following [the guide](https://modelcontextprotocol.io/quickstart/server#set-up-your-environment).\n\n# Setup\n\nFollow the steps to use this MCP server with Claude Desktop:\n 1. Download the repository to your local.\n 2. Setup the `uv` package manager, you can once again refer to [the guide](https://modelcontextprotocol.io/quickstart/server#set-up-your-environment) to do so.\n 3. Make sure you have installed the Claude Desktop, if you haven't, kindly download from [here](https://claude.ai/download) for Windows and MacOS users, or follow [this guide](https://modelcontextprotocol.io/quickstart/client) for Linux user.\n 4. Open the `claude_desktop_config.json` in your choice of editor, if you do not having one yet, follow [this guide](https://modelcontextprotocol.io/quickstart/server#testing-your-server-with-claude-for-desktop) to create one.\n 5. Add the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ip2locationio\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/ip2locationio/src\",\n        \"run\",\n        \"server.py\"\n      ],\n      \"env\": {\n        \"IP2LOCATION_API_KEY\": \"\u003cYOUR API key HERE\u003e\"\n      }\n    }\n  }\n}\n```\n 6. Remember to replace the `/path/to/ip2locationio`  path with your actual path to IP2Location.io MCP server in local.\n 7. To get your API key, just [login](https://www.ip2location.io/log-in) to your dashboard and get it from there. Replaced the `\u003cYOUR API key HERE\u003e` in above with your actual API key.\n 8. Restart the Claude Desktop after save the changes, and you should see it appear in the `Search and tools` menu.\n\n# Usage\n\nJust enter your query about the IP in a chat in Claude Desktop. Some of the example query will be:\n\n- Where is the location of (IP)?\n- Where is (IP) located?\n- What is the coordinate of (IP)?\n\nFor instance, below is the result of the IP 8.8.8.8:\n\n![The output of the IP 8.8.8.8](example.png \"The output of the IP 8.8.8.8\")\n\nIn Claude Desktop, the model will automatically generate the output based on the result returned by IP2Location.io MCP server.\n\n# Environment Variable\n\n`IP2LOCATION_API_KEY`\n\nThe IP2Location.io API key, which allows you to query up to 50,000 per month and more details of the IP address. You can [sign up](https://www.ip2location.io/sign-up) for a free API key, or [subscribe](https://www.ip2location.io/pricing) to a plan to enjoy more benefits.\n\n# Tool\n\n`get_geolocation`\n\n**Description**\nFetch geolocation for the given IP address. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address.\n\n**Arguments**\nip (str): The IP address (IPv4 or IPv6) to analyze.\n\n**Returns**\nA JSON string containing the geolocation data. The result may include the following fields, depending on your API plan:\n\n- Location \u0026 Geography: Country, region, district, city, ZIP code, latitude \u0026 longitude, time zone.\n- Network \u0026 Connectivity: ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type.\n- Mobile Information: MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand.\n- Currency \u0026 Language: currency code, currency name, currency symbol, language code, language name.\n- Proxy \u0026 Security: proxy type, last seen, threat level/type, proxy provider, fraud score.\n- Others: IAB category, weather, elevation, population, and more.\n\nIf the request fails or the IP address is invalid, the tool will return an error message as a string.\n# License\n\nSee the LICENSE file.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fip2location%2Fmcp-ip2location-io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fip2location%2Fmcp-ip2location-io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fip2location%2Fmcp-ip2location-io/lists"}