Storied Collection Venues

Name: Storied Collection Venues
Author: jchauge

远程服务

storiedcollection.com其他01 天前更新

代码仓库访问官网

关于 Storied Collection Venues

Storied Collection Venues 是只读远程 MCP 服务，提供 Storied Collection 在英国、爱尔兰和法国的场地数据，适合寻找独家租用的城堡、庄园和 château。数据来自 Google Sheet，并按货币保留价格，不进行换算。

主要功能

01按条件搜索场地
02按名称查找场地并提供建议
03列出国家及场地数量
04筛选价格、入住人数和设施
05保留原始货币，不换算

适用场景

01寻找适合团体住宿的场地
02按价格上限筛选出租场地
03查找带直升机坪或电动汽车充电的场地

MCP 相关

只读远程 MCP 服务通过 Streamable HTTP 暴露场地搜索、场地详情和国家列表工具。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://storied-mcp.onrender.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http jchauge-storied https://storied-mcp.onrender.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"jchauge-storied":{"type":"http","url":"https://storied-mcp.onrender.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"jchauge-storied":{"type":"http","url":"https://storied-mcp.onrender.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"jchauge-storied":{"type":"http","url":"https://storied-mcp.onrender.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"jchauge-storied":{"serverUrl":"https://storied-mcp.onrender.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Storied Collection 场地 — 远程 MCP 服务

只读 MCP 服务（Streamable HTTP、无状态、JSON 响应），从 Google Sheet 1voQY3AHxjEasFCy3L2T1i1JsdzaD52AZnieFhASRLsM 的 Properties 标签页实时提供 Storied Collection 场地数据。缓存 5 分钟（CACHE_TTL_SECONDS）；如果刷新失败，则继续提供上次成功获取的数据。

端点：POST /mcp（GET / = 健康检查）

工具

search_venues：按 query、country、min_sleeps、max_price + max_price_currency（GBP/EUR，不进行货币换算）、max_minimum_nights、helipad、ev_charging、guest_house、sort_by 查询
get_venue：模糊、不区分重音符号的名称查找；无匹配项时提供建议
list_countries：列出国家、场地数量和货币

每个价格都会连同其货币一起返回。数值永远不会进行换算。解析规则："3,000"→3000，"100+"→100（原始文本保留在 sleeps_display 中）， "1600s"→1600，"On request"/空白→null。空白的 Yes/No 单元格 → null（未知），布尔筛选条件会排除这些场地。

数据源（任选其一）

公开表格（默认）：将表格共享设置为知道链接的任何人都可以查看。服务会读取 gviz CSV 端点。
服务账号：将密钥 JSON 设置为 GOOGLE_SERVICE_ACCOUNT_JSON，并将表格以查看者权限共享给服务账号邮箱。
LOCAL_CSV=path.csv：本地文件，仅用于测试。

运行 / 测试

npm install && npm run build
npm start                                  # 读取公开表格；或使用 LOCAL_CSV=your.csv
npm test                                   # SDK 客户端端到端调用
npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp --transport http --method tools/list

部署（免费选项）

Render / Railway / Fly.io：任何 Node 主机均可。运行 npm run build && npm start；会使用 PORT。
Google Cloud Run：gcloud run deploy --source .（免费套餐）。可使用服务账号，无需密钥文件。
Cloudflare Workers 需要将代码移植到 Workers 运行时（不支持 Express）。src/data.ts 中的数据逻辑可以沿用。