<h1 align="center"> 📝 mcp-ip-geo </h1> <div align="center"> English | <a href="./README-zh_CN.md">简体中文</a> </div>

---

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

步骤 2：构建 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
• 局域网环境：使用服务器的内部 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/