mcp-ip-geolocator

🚀 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

2. 安装依赖项

yarn install

3. 构建并运行

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 许可证，你可以随意使用和修改！