shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

mcp-ip-geolocator

一个基于IP-API.com的免费IP地理定位服务MCP服务器

article

README

🚀 MCP IP 地理位置服务器

MCP IP 地理位置服务器是一个基于模型上下文协议（MCP）的服务器，它借助 IP-API.com 来提供 IP 地理位置服务。该服务免费使用，无需 API 密钥，能为用户提供便捷的 IP 定位功能。

🚀 快速开始

全局安装

npm install -g mcp-ip-geolocator

运行服务器

mcp-ip-geolocator

✨ 主要特性

  • 精准定位：可获取任意 IP 地址的详细位置信息。
  • 网络信息丰富：提供包括 ISP 和 AS 号在内的网络信息。
  • 时区数据支持：能获取 IP 对应的时区数据。
  • 使用便捷：无需 API 密钥或注册。
  • 输出友好：为 Claude 提供整洁、格式化的输出。

📦 安装指南

本地开发安装步骤

  1. 克隆仓库
git clone https://github.com/tedlikeskix/mcp-ip-geolocator.git
cd mcp-ip-geolocator
  1. 安装依赖项
yarn install
  1. 构建并运行
yarn build
yarn start

💻 使用示例

与 Claude 集成使用

服务器运行后，在 Claude Desktop 中连接到该服务器。示例用法如下：

Claude，你能检查一下 IP 地址 8.8.8.8 的位置吗？

Claude 将使用此工具获取并显示位置信息。

📚 详细文档

API 响应格式

工具返回的结构化数据包括：

  • 城市、区域和国家
  • 纬度和经度
  • 时区
  • ISP 和组织
  • AS 号

速率限制

IP-API.com 免费层包含：

  • 每分钟 45 个请求
  • 支持 IPv4 和 IPv6
  • 无需 API 密钥

📄 许可证

本项目采用 MIT 许可证，你可以随意使用和修改！

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client