项目简介
本项目是一个实现了 Model Context Protocol (MCP) 协议的服务器,专门用于提供 IP 地址的地理位置查询服务。它利用免费的 IP-API.com 服务,无需 API 密钥即可使用,为大型语言模型 (LLM) 应用提供 IP 地址的详细地理位置信息,包括城市、地区、国家、经纬度、时区、ISP 和 AS 编号等。
主要功能点
- IP 地理位置查询: 根据给定的 IP 地址,查询其详细的地理位置信息。
- 详细信息: 返回包括城市、地区、国家、经纬度、时区、互联网服务提供商 (ISP) 和自治系统 (AS) 编号等全面的地理位置信息。
- 免 API 密钥: 使用免费的 IP-API.com 服务,无需用户注册或提供 API 密钥即可直接使用。
- 结构化输出: 返回清晰、格式化的文本结果,方便 LLM 理解和使用。
安装步骤
- 全局安装: 打开终端,运行以下命令全局安装 'mcp-ip-geolocator':
npm install -g mcp-ip-geolocator
服务器配置
要将此 MCP 服务器连接到 MCP 客户端(例如 Claude),您需要提供以下服务器配置信息。客户端会使用这些信息来启动和连接到服务器。
{ "serverName": "IP Geolocator", "command": "mcp-ip-geolocator", "args": [] }
- 'serverName': 服务器的名称,可以自定义,用于在客户端中标识该服务器。例如 "IP Geolocator"。
- 'command': 启动服务器的命令。全局安装后,可以直接使用 'mcp-ip-geolocator' 命令来启动服务器。
- 'args': 启动命令的参数。此服务器启动不需要额外的命令行参数,因此参数列表为空 '[]'。
基本使用方法
- 启动服务器: 在终端中运行 'mcp-ip-geolocator' 命令启动服务器。服务器启动后,会显示 "Starting IP Geolocation MCP Server..." 的信息。
- 连接客户端: 在支持 MCP 协议的客户端(例如 Claude)中,配置上述服务器配置信息,连接到正在运行的 'IP Geolocator' 服务器。
- 使用工具: 连接成功后,即可在客户端中使用 'ip-geolocation' 工具。例如,在 Claude 中,您可以提问类似 "Claude, can you check the location of IP address 8.8.8.8?" 的问题。Claude 将会自动调用 'ip-geolocation' 工具查询 IP 地址的地理位置信息并返回结果。
信息
分类
网页与API