ip-info-mcp

MCP(Model Context Protocol) 프로토콜 기반의 IP 주소 정보 조회 서버로, stdio 전송 계층을 통해 AI 클라이언트와 통신합니다.

기능

• 본机 IP 조회 — 현재 공인 IP 및 지역 정보를 가져옵니다.

• 지정 IP 조회 — 임의의 IP 주소의 지역, ISP, 위도/경도 등을 조회합니다.

• 종합 조회 — IPv4/IPv6를 지원하며 호스트명, 기관, 우편번호, 시간대 등을 포함합니다.

Related MCP server: Netdetective MCP Server

MCP stdio 통신 메커니즘

이 프로젝트는 MCP 프로토콜의 stdio 전송 계층을 사용합니다:

┌─────────────────┐         ┌──────────────────────┐
│  AI 客户端        │  stdin  │  MCP Server (本进程)  │
│  (CodeBuddy 等)   │◄───────►│  python server.py     │
│                   │  stdout │                       │
└─────────────────┘         └──────────────────────┘

• 클라이언트는 stdin을 통해 JSON-RPC 요청(예: tools/call)을 전송합니다.

• 서버는 stdout으로 JSON-RPC 응답을 반환합니다.

• stderr는 로그 출력에 사용되며 통신 프로토콜에 영향을 주지 않습니다.

• HTTP 서비스가 필요하지 않아 가볍게 시작되며 로컬 도구 통합에 적합합니다.

빠른 시작

1. 의존성 설치

pip install -r requirements.txt

2. AI 클라이언트에 구성

CodeBuddy의 Settings → MCP → Add MCP에서 추가:

{
  "mcpServers": {
    "ip-info": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/server.py"],
      "description": "IP 地址信息查询工具"
    }
  }
}

3. 사용

구성 후 대화에서 바로 질문하세요:

• "내 공인 IP는 무엇인가요?"

• "8.8.8.8의 지역을 조회해 주세요."

• "이 IP 정보를 확인해 주세요: 114.114.114.114"

프로젝트 구조

ip-info-mcp/
├── server.py          # MCP 服务器主文件
├── requirements.txt   # Python 依赖
├── README.md          # 本文件
└── chatmcp.yaml       # chatmcp 平台配置

기술 스택

• MCP Python SDK — MCP 프로토콜 구현

• httpx — 비동기 HTTP 클라이언트

• ip-api.com / ipinfo.io — 무료 IP 조회 API

라이선스

MIT