Apartment Sheets MCP (AS-MCP)

Claude（またはその他のプラットフォーム）がアパートの物件情報を共有Googleスプレッドシートに保存・管理できるようにする、軽量なModel Context Protocol (MCP) サーバーです。

背景

このプロジェクトは、ここNYCでの慌ただしいアパート探しから着想を得ました。

なぜGoogleスプレッドシートなのか？

1. Googleは寛大なAPIサービスを提供しているため

2. ルームメイトやパートナーとアパート探しを共有するのに、これほど簡単な媒体はないため

Related MCP server: google-sheets-mcp

注意事項

これはMCPであるため、Webスクレイピングや物件情報の更新などは、お好みのAIプラットフォームを利用してください。このMCPは、お使いのAIツールが対象のスプレッドシートに接続できるようにする機能のみを提供します。

利用可能なツール

• save_listing : 新しい物件情報をシートに追加します

• get_listing : すべての物件情報を取得します（オプションで近隣地域や現在のステータスによるフィルタリングが可能）

• update_listing : 既存の物件情報の任意のフィールドを更新します

• delete_listing : シートから物件情報を削除します

セットアップ

*まずはこのリポジトリをクローンしてください！

1. Google Cloudの認証情報

• Google Cloud Consoleでサービスアカウントを作成します

• Google Sheets APIとGoogle Drive APIを有効にします

• 認証情報の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"
    }
  }
}

環境変数

セキュリティに関する注意

gitにプッシュする予定がある場合は、credentials.jsonを絶対にコミットしないように注意してください！