📝 mcp-ip-geo

📝 mcp-ip-geo

---

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（Streamable 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/