Apartment Sheets MCP (AS-MCP)

Легковесный сервер протокола Model Context Protocol (MCP), который позволяет Claude (или другим платформам) сохранять объявления об аренде квартир и управлять ими в общей таблице Google Sheets.

Предыстория

Этот проект был вдохновлен суматошным процессом поиска квартиры, с которым мы сталкиваемся здесь, в Нью-Йорке.

Почему 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

• Включите API Google Sheets и Google Drive

• Скачайте JSON с учетными данными и сохраните его как credentials.json (поместите в корень проекта)

• Предоставьте доступ к вашей Google Таблице сервисному аккаунту с правами редактора

2. Установка зависимостей

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

3. Настройка Claude desktop

Добавьте в ~/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"
    }
  }
}

Переменные окружения

Примечание по безопасности

Если вы планируете делать push в git, пожалуйста, убедитесь, что вы никогда не коммитите credentials.json!