korea-geocoder-mcp

wowzoo/korea-geocoder-mcp

3.1

If you are the rightful owner of korea-geocoder-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Korea Geocoder MCP Server is designed to convert Korean addresses into latitude and longitude coordinates using the Google Maps API.

Korea Geocoder MCP Server

ํ•œ๊ตญ ์ฃผ์†Œ๋ฅผ ์œ„๋„/๊ฒฝ๋„๋กœ ๋ณ€ํ™˜ํ•˜๋Š” MCP (Model Context Protocol) ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

  • ํ•œ๊ตญ ์ฃผ์†Œ๋ฅผ Google Maps API๋ฅผ ํ†ตํ•ด ์œ„๋„/๊ฒฝ๋„๋กœ ๋ณ€ํ™˜

์‚ฌ์ „ ์ค€๋น„

Google Maps Geocoding API ์„ค์ •

  1. Google Cloud Console์—์„œ API ํ‚ค ์ƒ์„ฑ
    • Google Cloud Console์— ์ ‘์†
    • ์ƒˆ ํ”„๋กœ์ ํŠธ ์ƒ์„ฑ ๋˜๋Š” ๊ธฐ์กด ํ”„๋กœ์ ํŠธ ์„ ํƒ
    • "API ๋ฐ ์„œ๋น„์Šค" > "๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ"๋กœ ์ด๋™
    • "Geocoding API" ๊ฒ€์ƒ‰ ํ›„ ํ™œ์„ฑํ™”
    • "API ๋ฐ ์„œ๋น„์Šค" > "์‚ฌ์šฉ์ž ์ธ์ฆ ์ •๋ณด"๋กœ ์ด๋™
    • "์‚ฌ์šฉ์ž ์ธ์ฆ ์ •๋ณด ๋งŒ๋“ค๊ธฐ" > "API ํ‚ค" ์„ ํƒ
    • ์ƒ์„ฑ๋œ API ํ‚ค ๋ณต์‚ฌ

์‚ฌ์šฉ๋ฒ•

Claude Desktop์—์„œ ์‚ฌ์šฉํ•˜๊ธฐ

Claude Desktop์—์„œ MCP ์„œ๋ฒ„๋ฅผ ๋“ฑ๋กํ•˜๊ณ  ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

  • Claude Desktop์˜ Settings์—์„œ Developer ์„น์…˜์œผ๋กœ ์ด๋™
  • Edit Config๋ฅผ ์„ ํƒํ•˜์—ฌ claude_desktop_config.json ํŒŒ์ผ์„ ํŽธ์ง‘ํ•ฉ๋‹ˆ๋‹ค.
uvx ์‚ฌ์šฉ (๊ถŒ์žฅ)
{
  "mcpServers": {
    "korea-geocoder-mcp": {
      "command": "uvx",
      "args": ["korea-geocoder-mcp@latest"],
      "env": {
        "GOOGLE_CLOUD_API_KEY": "๋ฐœ๊ธ‰๋ฐ›์€_API_ํ‚ค๋ฅผ_์—ฌ๊ธฐ์—_์ž…๋ ฅ"
      }
    }
  }
}
๊ฐœ๋ฐœ ํ™˜๊ฒฝ
{
  "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์„ ๋‹ค์‹œ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.