IP Geolocation MCP Server

IP Geolocation MCP Server

site icon
2025.03.13 16
PythonIP 地理定位服务位置服务
mcp-server-ipinfo 是一个基于 Model Context Protocol (MCP) 的服务器,利用 ipinfo.io API 获取 IP 地址的详细信息。该服务可以用于确定用户的大致地理位置以及所使用的网络信息。
View on GitHub

Overview

基本能力

产品定位

mcp-server-ipinfo 是一个 IP 地理定位服务,用于获取 IP 地址的详细信息。

核心功能

  • 获取 IP 地址的详细信息,包括地理位置、组织和国家信息。

适用场景

  • 确定用户的大致地理位置。
  • 分析用户所使用的网络信息。

工具列表

  • get_ip_details: 用于获取 IP 地址的详细信息。
  • 输入: ip: 需要查询的 IP 地址。
  • 输出: IPDetails: 包含 IP 地址详细信息的 Pydantic 模型,包括位置、组织和国家信息。

常见问题解答

  • 该服务需要 ipinfo.io 的 API 令牌才能使用。
  • 该项目与 IPInfo 无隶属关系。

使用教程

使用依赖

  1. 需要创建一个 ipinfo.io 的 API 令牌。如果没有,可以在 https://ipinfo.io/signup 注册免费账户。

安装教程

  1. claude_desktop_config.json 文件的 mcpServers 部分添加以下内容:
    "ipinfo": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/briandconnelly/mcp-server-ipinfo.git",
        "mcp-server-ipinfo"
      ],
      "env": {
        "IPINFO_API_TOKEN": "<YOUR TOKEN HERE>"
      }
    }

调试方式

安装完成后,可以通过调用 get_ip_details 工具并传入 IP 地址进行调试。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。