ღ♥ღ❤Mcp-ip-geoღ♥ღ

한국어 |

---

mcp-ip-geo]는 ip-api.com 서비스를 사용하여 IP 위치 찾기 서비스 (국가, 지역, 도시, 등)를 제공하는 MCP([Model Context Protocol) 서버입니다.

MCP 통합

두 가지 방법으로 mcp-ip-geo 서비스를 통합할 수 있습니다.

방법 1: 이동 실행 명령 사용 (Stdio)

MCP]에 다음을 추가하면 GitHub에서 최신 버전을 직접 실행할 수 있습니다.

방법 2: Docker 사용 (Streamable HTTP)

## 브룩 독러 배포

단계 1: 저장소를 복제

Step 2: Docker 이미지 구축

단계 3: 콘테이너를 달리십시오

성공적으로 실행되면, 서비스는 컨테이너 내에서 0.0.0.0:8000]을 듣게됩니다 (모든 네트워크 인터페이스에 표시), 그리고 http:// :8000/mcp]를 통해 액세스 할 수 있습니다, 어디 :

• 로컬 개발 환경: localhost 또는 127.0.0.1를 사용
• LAN 환경 : 서버 내부 IP 주소를 사용합니다 (예 : [T10]])
• 공용 네트워크 환경 : 서버의 공용 IP 주소 또는 도메인 이름을 사용하십시오.

참고 : 서비스는 `0.0.0.를 듣는 것으로 구성됩니다.

📝 mcp-ip-geo

---

mcp-ip-geo is an MCP (Model Context Protocol) server that provides IP geolocation lookup services (country, region, city, etc.) using the ip-api.com service.

🔌 MCP Integration

You can integrate the mcp-ip-geo service in two ways:

Method 1: Using the go run command (Stdio)

Add the following to your MCP configuration to run the latest version directly from GitHub:

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

Method 2: Using Docker (Streamable HTTP)

🐳 Docker Deployment

Step 1: Clone the repository

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

Step 2: Build the Docker image

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

Step 3: Run the container

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

Once running successfully, the service will listen on 0.0.0.0:8000 within the container (listening on all network interfaces), and can be accessed via http://:8000/mcp, where `` can be:

• Local development environment: Use localhost or 127.0.0.1
• LAN environment: Use the server’s internal IP address (e.g., 192.168.x.x)
• Public network environment: Use the server’s public IP address or domain name

Note: The service is configured to listen on the 0.0.0.0 address inside the container, which is standard practice for containerized applications, ensuring the service can be accessed from outside the container.

Step 4: Configure MCP

Add the following to your MCP configuration:

{
  "mcpServers": {
    "mcp-ip-geo": {
      "url": "http://:8000/mcp"
    }
  }
}

Replace `` with the actual server IP address or domain name of your deployment environment.

⚠️ License Notice

Note: This project uses the free version of ip-api.com, which is for non-commercial use only. If you intend to use this project for commercial purposes, please comply with their terms of service or purchase the paid version: https://ip-api.com/