使用说明

项目简介

IP Geolocation MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它通过调用 ipinfo.io API，为 LLM 客户端提供查询 IP 地址地理位置信息的工具。借助此服务器，LLM 应用可以轻松获取用户的粗略地理位置、网络服务提供商等信息，从而实现更丰富的上下文感知功能。

主要功能点

IP地址信息查询工具 (Tool): 提供 'get_ip_details' 工具，允许 LLM 客户端查询指定 IP 地址的详细信息，包括地理位置、国家、城市、组织、运营商等。
基于标准 MCP 协议: 遵循 MCP 协议规范，易于集成到支持 MCP 协议的 LLM 客户端，如 Claude。
灵活的 IP 查询: 支持查询指定 IP 地址，也支持查询请求客户端自身的 IP 地址信息。
详细信息模型: 返回结构化的 'IPDetails' 模型，包含丰富的 IP 地址相关数据字段。

安装步骤

获取 IPInfo API Token: 访问 https://ipinfo.io/signup 注册并获取免费或付费的 API Token。
安装 uvx (如果尚未安装): uvx 是一个用于运行和管理 MCP 服务器的工具。您可以根据 uvx 的官方文档进行安装。通常可以使用 pip 安装：
```
pip install uvx
```
配置 MCP 服务器: 编辑您的 MCP 客户端配置文件（例如 Claude desktop 的 'claude_desktop_config.json'），在 'mcpServers' 部分添加以下配置信息。请将 '<YOUR TOKEN HERE>' 替换为您在步骤 1 中获取的 IPInfo API Token。

服务器配置

以下是在 'claude_desktop_config.json' 中配置 IP Geolocation MCP Server 的示例。

{
  "mcpServers": {
    "ipinfo": {  //  服务器名称，可以自定义
      "command": "uvx",  //  启动服务器的命令，这里使用 uvx
      "args": [   //  传递给 uvx 的参数
        "--from",  //  指定服务器代码来源
        "git+https://github.com/briandconnelly/mcp-server-ipinfo.git", //  从 GitHub 仓库地址拉取代码
        "mcp-server-ipinfo" //  指定仓库中的子目录或入口点，这里是仓库名，uvx 会自动找到 server.py 运行
      ],
      "env": {   //  设置环境变量
        "IPINFO_API_TOKEN": "<YOUR TOKEN HERE>"  //  IPInfo API Token，用于访问 ipinfo.io API，**请替换为您的实际 Token**
      }
    }
  }
}

配置说明:

'"ipinfo"': 是您为该 MCP 服务器自定义的名称，在客户端中通过此名称引用该服务器。
'"command": "uvx"' 和 '"args"': 指示客户端使用 'uvx' 工具从指定的 GitHub 仓库地址安装并运行 MCP 服务器。
'"env"': 设置环境变量，'IPINFO_API_TOKEN' 用于传递您的 IPInfo API Token 给服务器程序，这是必须配置的，否则工具将无法正常工作。

基本使用方法

配置完成后，您的 MCP 客户端 (如 Claude) 应该能够检测到名为 "ipinfo" 的 MCP 服务器。您可以在 Prompt 中通过 'tool_code' 或自然语言指令调用 'get_ip_details' 工具来查询 IP 地址信息。

工具调用示例 (tool_code):

{"tool_code": "ipinfo.get_ip_details", "tool_parameters": {"ip": "8.8.8.8"}}

工具调用示例 (自然语言指令):

请使用 ipinfo 工具查询 IP 地址 8.8.8.8 的详细信息。

服务器将返回包含 IP 地址详细信息的 JSON 响应，客户端可以根据需要解析和利用这些信息。

注意:

首次运行或更新服务器代码时，'uvx' 可能会需要一些时间来下载和安装依赖。
'IPINFO_API_TOKEN' 环境变量是必需的，请务必正确配置您的 API Token。
请参考 ipinfo.io 了解 API 的使用限制和定价。

关键词