Apartment Sheets MCP (AS-MCP)

Claude(또는 기타 플랫폼)가 아파트 매물을 공유 Google 스프레드시트에 저장하고 관리할 수 있도록 지원하는 경량 MCP(Model Context Protocol) 서버입니다.

배경

이 프로젝트는 뉴욕에서 겪었던 복잡한 아파트 구하기 과정에서 영감을 받았습니다.

왜 Google 스프레드시트인가요?

1. Google은 관대한 API 서비스를 제공합니다.

2. 룸메이트나 파트너와 아파트 검색 결과를 공유하기에 이보다 더 쉬운 매체는 없습니다.

Related MCP server: google-sheets-mcp

참고 사항

이것은 MCP이므로, 웹 스크래핑, 매물 업데이트 등을 처리하려면 원하는 AI 플랫폼을 사용하세요. 이 MCP는 사용 중인 AI 도구가 해당 스프레드시트에 연결할 수 있는 기능만 제공합니다.

사용 가능한 도구

• save_listing : 스프레드시트에 새 매물을 추가합니다.

• get_listing : 모든 매물을 가져오며, 선택적으로 필터링(동네 및 상태)할 수 있습니다.

• update_listing : 기존 매물의 필드를 업데이트합니다.

• delete_listing : 스프레드시트에서 매물을 삭제합니다.

설정

*먼저 이 저장소를 복제해야 합니다!

1. Google Cloud 자격 증명

• Google Cloud Console에서 서비스 계정을 만듭니다.

• Google Sheets 및 Google Drive API를 활성화합니다.

• 자격 증명 JSON을 다운로드하여 credentials.json으로 저장합니다(프로젝트 루트에 배치).

• Google 스프레드시트를 서비스 계정 이메일과 공유하고 편집자 권한을 부여합니다.

2. 종속성 설치

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Claude 데스크톱 구성

~/Library/Application Support/Claude/claude_desktop_config.json에 다음을 추가합니다:

{
  "mcpServers": {
    "nyc-apartment-tracker": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/server.py"],
      "cwd": "/path/to/nyc-apartment-mcp"
    }
  }
}

환경 변수

보안 참고 사항

Git에 푸시할 계획이라면 credentials.json을 절대 커밋하지 않도록 주의하세요!