Apartment Sheets MCP (AS-MCP)

一个轻量级的模型上下文协议 (MCP) 服务器，允许 Claude（或其他平台）将公寓房源保存并管理到共享的 Google 表格中。

背景

本项目灵感来源于我们在纽约经历的繁忙的公寓搜寻过程。

为什么选择 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 控制台中创建服务账号

• 启用 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！