Apartment Sheets MCP (AS-MCP)

Ein leichter Model Context Protocol (MCP)-Server, der es Claude (oder anderen Plattformen) ermöglicht, Wohnungsanzeigen in einer gemeinsamen Google-Tabelle zu speichern und zu verwalten.

Hintergrund

Dieses Projekt wurde durch die hektische Wohnungssuche hier in NYC inspiriert.

Warum eine Google-Tabelle?

1. Google bietet einen großzügigen API-Dienst

2. Es gibt kein einfacheres Medium, um Ihre Wohnungssuche mit Ihrem Mitbewohner/Ihrer Mitbewohnerin oder Partner/Partnerin zu teilen

Related MCP server: google-sheets-mcp

Hinweise

Da es sich um ein MCP handelt, nutzen Sie die KI-Plattform Ihrer Wahl, um das Web-Scraping, die Aktualisierung der Anzeigen und mehr zu übernehmen. Alles, was dieses MCP tut, ist Ihrem KI-Tool Ihrer Wahl die Konnektivität zu Ihrer jeweiligen Tabelle zu geben.

Verfügbare Tools

• save_listing : fügt Ihrer Tabelle eine neue Anzeige hinzu

• get_listing : ruft alle Anzeigen ab, mit optionalen Filtern (Stadtteil und Status heute)

• update_listing : aktualisiert ein beliebiges Feld einer bestehenden Anzeige

• delete_listing : entfernt eine Anzeige aus der Tabelle

Einrichtung

*Sie müssen dieses Repo klonen, natürlich!

1. Google Cloud-Anmeldedaten

• Erstellen Sie ein Dienstkonto in der Google Cloud Console

• Aktivieren Sie die Google Sheets- und Google Drive-APIs

• Laden Sie die Anmeldedaten als JSON herunter und speichern Sie sie als credentials.json (im Stammverzeichnis des Projekts ablegen)

• Teilen Sie Ihre Google-Tabelle mit der E-Mail-Adresse des Dienstkontos als Editor

2. Abhängigkeiten installieren

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

3. Claude Desktop konfigurieren

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Umgebungsvariablen

Sicherheitshinweis

Wenn Sie planen, auf Git zu pushen, stellen Sie bitte sicher, dass Sie niemals die credentials.json committen!