서울시 개별공시지가 정보 MCP

서울 열린데이터광장의 서울시 개별공시지가 정보(IndividuallyPostedLandPriceService)를 MCP 툴로 제공하는 서버입니다. 시군구명·기준년도(+ 법정동/본번/부번/필지구분코드)로 개별 필지의 공시지가(원/㎡)를 조회합니다.

제공 툴

get_individual_land_price

시군구명과 기준년도로 개별공시지가를 조회합니다. 법정동명/본번/부번/필지구분코드로 추가 필터링 가능.

응답 필드: 시군구명/시군구코드/법정동명/법정동코드/본번/부번/필지구분명/필지구분코드/ 기준년월(YYYY-MM-DD 형식)/공시지가(원/㎡)/기준년도

⚠️ 실측으로 확인된 제약 (DEVLOG.md 참고):

• bjdong_nm/bonbeon/bubeon/pilgi_cd는 넷 다 채우거나 넷 다 비워야 합니다. 하나라도 부분적으로만 채우면 서울시 API가 ERROR-500(서버 오류)을 반환합니다. 이 서버는 부분 채움을 감지하면 API를 호출하기 전에 ERROR-CLIENT-PARTIAL-PARAMS로 안내합니다.

• 시군구명+기준년도만으로(선택 파라미터 4개를 전부 비운 채) 여러 건을 조회하는 것은 지원되지 않습니다. 이 조합도 ERROR-500을 반환하는 것으로 실측되었습니다. start_index/end_index로 실제 여러 건(list_total_count > 1)이 반환되는 유효한 조합은 아직 확인하지 못했습니다 — 4개 파라미터를 모두 채운 유효 요청은 필지 단위로 좁혀져 통상 1건만 반환됩니다.

Related MCP server: Korea Housing MCP

설치 및 로컬 실행

pip install -r requirements.txt
cp .env.example .env   # SEOUL_API_KEY 값 입력 (BOM 없이 저장할 것)
python server.py

환경변수

배포 (fly.io)

fly launch --no-deploy
fly secrets set SEOUL_API_KEY=발급받은키
flyctl deploy

배포 후 Claude.ai > 설정 > 커넥터에서 연결하고, "사용 가능한 도구" 목록에 툴이 뜨는지 확인하세요.

라이선스 / 출처

• 원데이터: 서울특별시 (도시공간본부 토지관리과)

• 이용허락조건: 공공누리 1유형 (출처표시, 상업적 이용 및 변경 가능)

• 출처 표기 예: "본 서비스는 서울열린데이터광장의 개별공시지가 정보를 사용합니다."