Dutch Property Context — MCP 서버 및 네덜란드 주소용 API

주소 하나를 넣으면, 연결된 건물 보고서가 나옵니다. BAG의 건축연도와 면적, 등록된 에너지 라벨, CBS 동네 통계, 주변 소음과 대기질, 국립기념물 지정 여부, 보호된 도시·마을 경관, 그리고 주변 학교 정보를 제공합니다.

원격 MCP 서버 및 일반 HTTPS API로 작동합니다. 무료이며, API 키도 등록도 필요 없습니다.

https://property-context.tradebrite.nl

📖 문서: https://tradebrite.nl/property-context/

10초 만에 연결하기

Claude (웹 또는 데스크톱, 모든 요금제): Customize → Connectors → + → Add custom connector에서 https://property-context.tradebrite.nl/mcp를 붙여넣으세요.

ChatGPT: 커스텀 커넥터는 Developer Mode(Pro/Team/Enterprise/Edu)가 필요합니다. Plus에서는 사용할 수 없으니 HTTPS API를 이용하세요.

Claude Code:

claude mcp add --transport http property-context https://property-context.tradebrite.nl/mcp

또는 MCP 설정 파일(Claude Desktop, Cursor, Windsurf 등)에 직접 추가:

{
  "mcpServers": {
    "property-context": {
      "type": "http",
      "url": "https://property-context.tradebrite.nl/mcp"
    }
  }
}

그런 다음 이렇게 물어보세요: "하를렘 그로테 마르크트 2번지를 보러 가기 전에 알아야 할 것은?"

그냥 HTTP로 쓰고 싶다면:

curl "https://property-context.tradebrite.nl/v1/property/context?address=Grote%20Markt%202,%20Haarlem"

Related MCP server: homedata-mcp

왜 이런 것이 필요한가

AI 에이전트에게 네덜란드 주소를 물어보면 웹을 검색합니다. 그 결과는 그럴듯해 보이고 때로는 맞는 답변입니다. 기반 데이터는 공개적이고 신뢰할 수 있지만, 각각 고유한 키, 형식, 특이점을 가진 아홉 개의 등록부에 흩어져 있습니다.

가장 어려운 부분은 데이터를 가져오는 것이 아니라 연결(koppelen) 하는 일이었고, 우리가 제대로 파악하기 전까지는 반복적으로 실패했습니다:

• 우리가 공개한 기념물 번호가 내부 객체 번호인 것으로 드러났습니다. Prinsengracht 263은 기념물 등록부에서 Zierikzee의 건물을 가리키는 번호를 받았습니다.

• 기념물 쿼리가 위치 기반이 아니어서, Asten의 주소가 Coevorden의 기념물로 지정되었습니다.

• Binnenrotte 101, Amsterdam은 아무런 조건 없이 Rotterdam의 건물을 반환했고, match_verified: true로 표시되었습니다.

어떤 소스도 고장나지 않았습니다. 연결(매칭)이 고장난 것이었습니다. 이 레이어가 그 작업을 대신하고, 올바른 건물을 찾았는지 얼마나 확신하는지 명시적으로 알려줍니다.

무엇을 돌려받는가

identity, building, energy, location, neighbourhood, environment, heritage, protected_area, schools, signals, provenance를 포함한 JSON 응답(약 11kB)입니다.

identity.match_verified에 주의하세요. 이 값이 false이면 요청한 주소가 확실하게 찾아지지 않은 것이며, 나머지 응답은 다른 건물에 대한 것일 수 있습니다. match_ambiguous에는 동등하게 유력한 모든 후보가 함께 표시됩니다.

signals는 관찰 사항이지, 확정된 결함이 아닙니다. 건축연도 1921이 낡은 배선이 있다는 뜻은 아니며, 점검해 볼 가치가 있다는 뜻입니다.

하지 않는 일

감정평가, 주택 가치, 법률 또는 건축 자문은 제공하지 않습니다. 매물 가격, 지상권료, VvE 정보, 소유 이력도 제공하지 않습니다 — 이들은 자유롭게 이용할 수 없기 때문입니다.

설계 원칙

1. 누락된 값을 그럴듯해 보인다고 임의로 채우지 않는다.

2. 사실 ≠ 신호 ≠ 알 수 없음.

3. 소스별 출처 표기(provenance) — depth=compact에서도 포함. 일부 소스는 CC BY 라이선스이므로 출처 표기는 라이선스 조건입니다.

4. MCP 도구는 하나, 수십 개가 아님. 우리의 도구 목록은 2,419자입니다. 옆에 두었던 광범위한 네덜란드 오픈데이터 MCP는 64개 도구에 55,452자였습니다.

5. 실패한 소스는 눈에 띄게 표시된다.

6. 채워지지 않을 필드는 응답에 넣지 않는다.

직접 실행하기

npm install
python3 scripts/build_school_index.py     # bouwt data/schools.json
python3 scripts/build_amenities_index.py  # bouwt data/amenities.json
python3 scripts/build_places_index.py     # bouwt data/places.json
npx wrangler deploy                       # vul eerst je account_id in wrangler.toml
node regression.mjs                       # dertien gevallen tegen de live dienst

인덱스 파일은 의도적으로 저장소에 포함하지 않았습니다. CC BY 소스에서 파생되며 몇 분 안에 다시 구축할 수 있습니다. EP_ONLINE_KEY(RVO에 무료로 신청 가능)는 선택 사항이며, 이 키가 없으면 에너지 라벨만 not_configured로 빠집니다.

번들 크기 제한에 주의하세요. 약 3.7MB를 넘으면 Cloudflare Worker의 콜드 스타트가 0.2초에서 9초로 늘어납니다. /health에서도 마찬가지입니다. 격리된 환경에서 측정했습니다. 따라서 R2 없이는 네 번째 인덱스를 추가할 수 없습니다.

소스 및 라이선스

BAG(Public Domain Mark 1.0) · EP-Online/RVO(자체 조건, 대량 다운로드 없음) · CBS 구역·동네 및 핵심 지표(CC BY 4.0) · RIVM 소음 및 대기질(퍼블릭 도메인) · RCE 국립기물 및 보호 구역(CC BY 4.0) · DUO 교육 주소(CC BY).

이 중 일부는 출처 표기가 의무입니다. 그래서 모든 응답에 provenance가 포함됩니다. 최종 사용자에게 데이터를 표시할 때 출처를 함께 전달하세요. 그 의무는 데이터와 함께 이동합니다.

코드: MIT, LICENSE 참조.

개인정보 보호

호스팅 서비스는 주소, 우편번호, IP 주소를 기록하지 않습니다. 기록하는 것은 지자체(대략적인 수준), 생성된 신호, 소스 상태뿐입니다.

관련 프로젝트

Dutch Vehicle Context — 네덜란드 차량에 대한 동일한 접근 방식: 번호판 입력, APK 이력, 반복되는 결함 지점, 전체 리콜 체인 출력.

Tradebrite BV 제작 · info@tradebrite.nl