v0.2.0 — 로그인 없는 로컬 설치

각자 GitHub에서 내려받아 자신의 PC에 설치하고 Claude Desktop·Claude Code·Codex에서 사용하는 경로를 기본으로 바꿨습니다.

• 로컬 MCP 연결에는 이메일, 별도 청약 도우미 계정, 서버 주소, Docker, Render 계정이 필요하지 않습니다.
• npm ci 후 npm run setup에서 연결할 AI를 선택합니다. 기존 AI 설정을 보존하며, 자동 등록이 어려운 환경에서는 실행할 명령을 안내합니다.
• AI가 로컬 stdio 프로그램을 실행합니다. 별도 서버 터미널을 계속 켜 둘 필요가 없습니다.
• 자료는 OS 사용자별 폴더의 SQLite 파일에 저장됩니다. 같은 PC 사용자와 저장 위치를 쓰는 Claude·Codex가 자료를 공유하며, 다른 PC로 자동 동기화되지는 않습니다.
• 공고 API 키는 선택 사항입니다. 계산과 개인 자료 저장·조회는 키 없이 사용할 수 있습니다.

기존 HTTP 공유 서버를 운영한다면 명령이 npm run setup:http, npm run start:http로 바뀌었습니다. 원격 인증과 사용자별 데이터 분리는 유지되며, 기존 서버의 계정·자료를 로컬 모드로 자동 이동하지 않습니다.

설치 안내: https://github.com/ANNJUNGCHAN/housing-mcp/blob/main/docs/getting-started.md
문제 해결: https://github.com/ANNJUNGCHAN/housing-mcp/blob/main/docs/troubleshooting.md

ZIP에는 소스와 안내만 포함되며 개인 자료, AI 설정 파일, 인증키는 포함하지 않습니다. Claude 웹·모바일에서의 원격 연결은 별도의 HTTPS 서버가 필요한 선택 기능입니다.

검증: 전체 문법 검사와 63개 테스트 통과. 실제 SDK stdio 프로세스의 도구 검색·동시 저장·재시작·데이터 분리, 기존 AI 설정 보존과 백업을 확인했습니다. 실제 사용자의 Claude·Codex 앱 설정을 변경하거나 앱 화면에서 연결한 검증은 포함하지 않습니다.

Windows·Ubuntu(Node 22.14/24), macOS(Node 24), 선택적 HTTP 컨테이너의 6개 자동 검사 작업이 모두 통과했습니다: https://github.com/ANNJUNGCHAN/housing-mcp/actions/runs/41947906313

v0.1.2 — Render 공유 서버 배포 지원

운영자가 Render에 공유 서버를 만들 수 있는 배포 설정과 한국어 안내를 추가했습니다. 이 릴리스 자체가 공개 서버를 생성하지는 않습니다.

• Render 기본 HTTPS 주소를 자동으로 사용하며, 직접 지정한 PUBLIC_URL이 있으면 그 값을 우선합니다. 기존 HTTPS·호스트·인증 검사는 유지됩니다.
• Native Node.js 24.22.1, 단일 인스턴스, 1GB 영구 디스크, 수동 배포 설정을 제공합니다. 기본 예상 비용은 월 $7.25이며 세금·초과 사용량은 별도입니다.
• 실행 중인 서버에서의 사용자 초대, Claude·Codex 연결, 데이터 보존과 백업 절차를 설명했습니다.
• 버전을 0.1.2로 맞췄습니다. 사용자 로그인과 데이터 분리 동작은 유지됩니다.

설치 안내: https://github.com/ANNJUNGCHAN/housing-mcp/blob/main/README.md
Render 배포 안내: https://github.com/ANNJUNGCHAN/housing-mcp/blob/main/docs/render-deployment.md

ZIP에는 프로그램과 문서만 들어 있으며, 계정·개인 자료·API 키는 포함하지 않습니다.

청약 도우미 MCP v0.1.1 — 시작·사용 안내 개선

청약 도우미 MCP v0.1.1 — 처음 쓰는 사람을 위한 안내 개선

설치부터 AI에 첫 요청을 보내는 단계까지 설명을 다시 정리했습니다. 새 사용자는 자신에게 맞는 경로를 선택하고 따라갈 수 있으며, 기존 사용자는 같은 계정과 저장 자료를 이어서 사용합니다.

달라진 점

• README에서 초대받아 연결 / 내 PC에 설치 / 공유 서버 운영을 구분합니다.
• 시작 안내는 설치 명령, 정상 출력, 가입 순서, Claude·Codex 인증을 단계별로 설명합니다.
• 사용 예시는 조건 저장, 공고 확인, 주거비·대출·자금 계획, 후보 관리에 쓸 요청을 제공합니다.
• 문제 해결은 설치·계정·인증·조회·업데이트 문제를 다룹니다.
• 설치 도구와 계정 화면에서 서버 시작, 가입, 연결 승인 후 해야 할 일을 안내합니다.
• 공고 수집 범위, 자료의 전체 교체 저장, 다른 서버 계정과의 차이, 데이터 보관과 연결 철회의 의미를 명확히 했습니다.
• 기여 안내와 오류·개선 제안 양식을 추가했습니다.

처음 실행하기

Node.js 22.14 이상을 준비하고 housing-mcp.zip을 풀어 package.json이 있는 폴더에서 순서대로 실행합니다.

npm ci
npm run setup
npm start

서버를 시작한 뒤 setup에서 받은 가입 링크를 여세요. 이미 공유 서버 초대를 받았다면 로컬 설치 없이 가입과 AI 연결 안내부터 따르면 됩니다. Docker는 선택 사항입니다.

기존 설치 업데이트

서버를 멈추고 .env와 DATA_DIR 전체를 백업하세요. Git 설치는 git pull --ff-only와 npm ci 후 다시 실행합니다. ZIP 설치는 새 버전을 다른 폴더에 풀고 기존 환경 설정과 데이터 경로를 복원해 사용합니다. 기존 데이터 형식·도구 이름·인증 방식은 유지되며 별도 데이터 변환은 필요하지 않습니다.

일반 Claude 원격 연결에는 공개 HTTPS 서버가 필요합니다. 계산·개인 자료 저장은 API 키 없이 사용할 수 있고, 공고 API 조회에는 공공데이터포털 키와 서비스 활용신청이 필요합니다.

검증

• 문법 검사와 회귀 테스트 42개 통과.
• 릴리스 커밋의 GitHub Actions: Windows·Ubuntu / Node.js 22.14·24 및 Docker 빌드·실행 검사 5개 작업 모두 통과.
• Markdown 문서 10개의 상대 링크 68개와 이슈 양식 YAML 3개 검사 통과.
• 독립 검토에서 문서·화면 안내와 실제 인증·저장·지역 검색 동작 대조 완료.
• 공개 변경 파일의 비밀정보 검사에서 탐지 결과 없음. ZIP에는 소스·문서 52개를 포함하며 설정·개인 데이터·의존성 설치 폴더는 포함하지 않습니다.

SHA256SUMS.txt로 다운로드한 ZIP의 무결성을 확인할 수 있습니다. 운영 HTTPS 배포와 실제 AI 계정 연결은 사용하는 환경에서 확인합니다.

청약 도우미 MCP v0.1.0

청약 도우미 MCP v0.1.0

Claude·Codex에서 청약 조건, 공고 비교, 주거비·대출 계산, 후보·자금 계획 저장을 이용하는 독립 실행 서버의 첫 공개 배포입니다.

다운로드와 실행

아래 housing-mcp.zip을 내려받아 압축을 풀고, package.json이 있는 폴더에서 실행합니다. Node.js 22.14 이상이 필요하며 Docker는 선택 사항입니다.

npm ci
npm run setup
npm start

설치 도구에 이메일을 입력하고, 출력되는 가입 링크에서 서비스 계정 비밀번호를 정하세요. 이후 README의 Claude·Codex 연결 안내를 따릅니다.

포함한 기능

• 청약·주택 분석 MCP 도구 17개.
• 초대 가입, 브라우저 로그인, OAuth PKCE와 연결 권한 철회.
• 사용자별 프로필·후보·자금 계획 분리와 같은 계정의 AI 간 저장 자료 공유.
• 기존 설정과 계정을 보존하는 설치 도우미.
• Windows·Linux 직접 실행, 선택적 Docker·Caddy 배포 안내.
• MIT 라이선스와 의존성 잠금 파일.

이 배포본은 실행할 서버 소스입니다. 일반 Claude 웹·데스크톱의 원격 연결에는 운영자가 제공하는 외부 HTTPS 서버가 필요합니다. 각자 로컬로 실행할 때는 같은 PC의 Codex·Claude Code에 연결합니다. API 공고 목록 조회에는 별도의 공공데이터포털 키가 필요하며 계산·저장 도구는 키 없이 사용할 수 있습니다.

기존 개인 자료, API 키, 연구 DB와 비공개 저장소 이력은 포함하지 않습니다. SHA256SUMS.txt로 ZIP 무결성을 확인할 수 있습니다. 설치·운영·검증 범위는 저장소 문서를 참고하세요.

검증 결과

릴리스 커밋의 GitHub Actions에서 Windows·Ubuntu / Node.js 22.14·24의 테스트 42개와 Docker 빌드·비루트 실행·HTTP 인증 경계 검증이 모두 통과했습니다. 공개 파일 대상 비밀정보 검사에서도 탐지 결과가 없었습니다. 실제 Claude·Codex 외부 계정 연결과 운영 HTTPS 배포는 설치한 환경에서 확인해야 합니다.