AI导哈

IP地理位置查询服务

mcp-ip-geo是一个基于MCP协议的服务器，提供IP地理位置查询服务（国家、地区、城市等），可通过go run或Docker部署。

  • by chenmingyong0423
  • Go
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 chenmingyong0423/mcp-ip-geo

使用说明

📝 mcp-ip-geo

English | 简体中文

mcp-ip-geo 是一个 MCP (Model Context Protocol)使用IP-api.com服务提供IP地理定位查找服务（国家、地区、城市等）的服务器。

🔌 MCP集成

您可以整合 mcp-ip-geo 服务方式有两种：

方法1：使用go run命令（Stdio）

将以下内容添加到您的 MCP 配置以直接从GitHub运行最新版本：

{
  "mcpServers": {
    "mcp-ip-geo": {
      "command": "go",
      "args": [
        "run",
        "github.com/chenmingyong0423/mcp-ip-geo/cmd/mcp-ip-geo@latest"
      ]
    }
  }
}

方法2：使用Docker（流式HTTP）

🐳 Docker部署

步骤1：克隆存储库

git clone https://github.com/chenmingyong0423/mcp-ip-geo.git
cd mcp-ip-geo

第二步：构建Docker镜像

docker build -t mcp-ip-geo-server .

步骤3：运行容器

docker run -d --name mcp-ip-geo-server -p 8000:8000 mcp-ip-geo-server

一旦成功运行，服务将继续监听 0.0.0.0:8000 在容器内（监听所有网络接口），可以通过以下方式访问 http://<server-address>:8000/mcp，在哪里 <server-address> 可以是：

  • 当地开发环境：使用 localhost 或 127.0.0.1
  • LAN环境：使用服务器的内部IP地址（例如。， 192.168.x.x)
  • 公共网络环境：使用服务器的公共IP地址或域名

注意：该服务被配置为监听 0.0.0.0 容器内的地址，这是容器化应用程序的标准做法，确保可以从容器外部访问服务。

步骤4：配置MCP

将以下内容添加到您的 MCP 配置：

{
  "mcpServers": {
    "mcp-ip-geo": {
      "url": "http://<server-address>:8000/mcp"
    }
  }
}

替换 <server-address> 使用部署环境的实际服务器IP地址或域名。

⚠️ 许可证通知

注意：本项目使用ip-api.com的免费版本 仅供非商业用途。如果您打算将此项目用于商业目的，请遵守其服务条款或购买付费版本：https://ip-api.com/

相关 MCP