Metadata-Version: 2.4
Name: korea-geocoder-mcp
Version: 0.1.0
Summary: A Model Context Protocol (MCP) server for geocoding Korean addresses using Google Maps API
Project-URL: Homepage, https://github.com/wowzoo/korea-geocoder-mcp
Project-URL: Repository, https://github.com/wowzoo/korea-geocoder-mcp
Project-URL: Issues, https://github.com/wowzoo/korea-geocoder-mcp/issues
Author-email: wowzoo <wowzoo@gmail.com>
License: MIT License
        
        Copyright (c) 2025 Keehyun Jang
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: address,coordinates,geocoding,korea,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.10.1
Requires-Dist: googlemaps>=4.10.0
Requires-Dist: requests>=2.32.4
Description-Content-Type: text/markdown

# Korea Geocoder MCP Server

한국 주소를 위도/경도로 변환하는 MCP (Model Context Protocol) 서버입니다.

## 기능

- 한국 주소를 Google Maps API를 통해 위도/경도로 변환

## 사전 준비

### Google Maps Geocoding API 설정

1. **Google Cloud Console에서 API 키 생성**
   - [Google Cloud Console](https://console.cloud.google.com/)에 접속
   - 새 프로젝트 생성 또는 기존 프로젝트 선택
   - "API 및 서비스" > "라이브러리"로 이동
   - "Geocoding API" 검색 후 활성화
   - "API 및 서비스" > "사용자 인증 정보"로 이동
   - "사용자 인증 정보 만들기" > "API 키" 선택
   - 생성된 API 키 복사

## 사용법

### Claude Desktop에서 사용하기

Claude Desktop에서 MCP 서버를 등록하고 사용할 수 있습니다:
- Claude Desktop의 Settings에서 Developer 섹션으로 이동
- Edit Config를 선택하여 claude_desktop_config.json 파일을 편집합니다.

#### uvx 사용 (권장)
```json
{
  "mcpServers": {
    "korea-geocoder-mcp": {
      "command": "uvx",
      "args": ["korea-geocoder-mcp@latest"],
      "env": {
        "GOOGLE_CLOUD_API_KEY": "발급받은_API_키를_여기에_입력"
      }
    }
  }
}
```

#### 개발 환경
```json
{
  "mcpServers": {
    "korea-geocoder": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/korea-geocoder-mcp",
        "run",
        "korea_geocoder_mcp.geocoder"
      ],
      "env": {
        "GOOGLE_CLOUD_API_KEY": "발급받은_API_키를_여기에_입력"
      }
    }
  }
}
```

- Claude Desktop을 다시 시작합니다.

