关于 charlotteonthecheap-mcp
charlotteonthecheap-mcp 提供对 On the Cheap 网络中免费及低价活动、优惠和本地指南的只读访问。它涵盖美国 14 个城市站点，每次调用都需指定站点，无需凭据或其他配置。
主要功能
- 01浏览每日活动的时间、价格和场地
- 02筛选免费活动
- 03按文本、类别、地点和日期搜索文章
- 04阅读全文并浏览类别或地点
- 05选择 14 个城市及全国站点
- 06按需搜索过期优惠
适用场景
- 01查找指定城市和日期的免费活动
- 02比较多个城市的本地活动
- 03按主题或地点搜索优惠
- 04阅读本地指南或查看历史文章
MCP 相关
通过只读 MCP 工具查询 On the Cheap 网络的公开站点。大多数工具都要求提供所查询城市或全国站点的键名。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
7收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tag | integer | 否 | 标签 ID |
| page | integer | 否 | 从 1 开始的页码 |
| after | string | 否 | 仅包含在此日期或之后发布的帖子 |
| query | string | 否 | 全文搜索，例如 "free museum day" |
| before | string | 否 | 仅包含在此日期或之前发布的帖子 |
| compact | boolean | 否 | 返回精简摘要而非完整记录（默认值为 true） |
| category | integer | 否 | 来自 cotc_list_categories 的类别 ID |
| location | integer | 否 | 来自 cotc_list_locations 的位置 ID |
| per_page | integer | 否 | 每页结果数（最多 100 条） |
| include_expired | boolean | 否 | 包含已撤下／过期的优惠（默认值为 false） |
详细介绍
onthecheap-mcp
适用于 On the Cheap 网络的 MCP 服务——为美国 14 座城市提供免费和低价活动的本地指南。每日活动列表包含时间、价格和场地，还有可搜索的优惠与指南档案。
由 AI（Claude Code）开发并维护。请自行斟酌使用。
无需凭据。 所有网站均为公开网站，因此服务会通过普通 HTTPS 在服务端读取内容。除了选择要查询的城市外，无需进行任何配置，也不涉及浏览器扩展。
安装
npx onthecheap-mcp
或作为 Claude Code 插件使用：
/plugin marketplace add chrischall/onthecheap-mcp
/plugin install onthecheap-mcp
选择城市
一个服务即可读取整个网络。每个工具都需要传入 site 参数来指定要读取的城市——没有默认城市，也无需配置：
| 键 | 网站 | 地区 |
|---|---|---|
charlotte | Charlotte On The Cheap | Charlotte, NC |
denver | Mile High on the Cheap | Denver, CO |
atlanta | Atlanta on the Cheap | Atlanta, GA |
chicago | Chicago on the Cheap | Chicago, IL |
columbus | Columbus on the Cheap | Columbus, OH |
seattle | Greater Seattle on the Cheap | Seattle–Tacoma |
kansascity | Kansas City on the Cheap | Kansas City |
miami | South Florida on the Cheap | Miami / Broward / Palm Beach |
orlando | Orlando on the Cheap | Orlando, FL |
portland | Portland Living on the Cheap | Portland, OR |
richmond | RVA on the Cheap | Richmond, VA |
southernmaine | Southern Maine on the Cheap | Southern Maine |
triangle | Triangle on the Cheap | Raleigh / Durham / Chapel Hill |
national | Living On The Cheap | 全美优惠（无本地活动日历） |
常见别名也可使用——milehigh、raleigh、rva、kc、southflorida。
otc_list_sites 会返回同一份列表。
有意要求提供 site，而不是设置默认值：如果服务悄悄回退到某个城市，那么用户询问 Denver 时就会得到 Charlotte 的数据，却看不出任何问题。若键无效，服务会拒绝请求并列出有效键。
工具
所有工具均为只读。除 otc_list_sites 外，所有工具都必须提供 site 参数。两个活动工具都不接受 national，因为该站点没有本地活动日历——但仍可通过其他工具搜索。
| 工具 | 功能 |
|---|---|
otc_list_events | 列出指定日期的所有活动，包括时间、价格和场地。free_only 可筛选免费活动。默认使用今天的日期。 |
otc_events_month_overview | 按日统计某个月的活动数量，方便查找活动最多的日期。每天的列表仅供预览；实际数量以 total 为准。 |
otc_search_posts | 按文本、类别、地点和日期范围搜索文章。默认返回精简摘要。 |
otc_get_post | 获取完整文章，以易读文本或原始 HTML 形式返回。可接受 id、slug 或 URL。 |
otc_list_categories | 返回类别 id 和文章数量，可用于按主题筛选搜索结果。 |
otc_list_locations | 返回本地区域 id 和文章数量，可用于按地理位置筛选。 |
otc_list_sites | 返回网络中的城市及其 site 键。不接受参数。 |
otc_healthcheck | 确认某个站点是否可访问；失败时，error.kind 的值为 edge_blocked、http、timeout 或 transport。 |
示例
Charlotte 本周六有哪些免费活动？
查找 8 月 Lake Norman 的儿童活动
比较下周末 Denver 和 Portland 的免费活动
两件值得了解的事
默认排除已结束的优惠。 每个网站都会将过期优惠归入
expired 类别，因此搜索会跳过这些优惠，避免显示已不存在的优惠。传入 include_expired: true 即可搜索存档。每个网站上的类别
id 都不同，因此会在请求时通过 slug 解析——硬编码 id 会在其他网站上悄无声息地禁用筛选。
类别和位置 id 因网站而异。 每个网站都是独立的 WordPress
安装，因此 id 13 在每个网站上对应的类别都不同。应针对之后要搜索的同一个 site 解析 id——借用其他城市的 id 不会报错，而是会筛选出无关内容。
月份概览是预览，数量如实呈现。 日历每天最多显示四个条目。otc_events_month_overview 会同时报告每天的实际总数和预览内容——要查看完整日程，请使用日期调用 otc_list_events。
配置
无需配置。城市通过每次调用时传入的 site 参数指定，而非环境变量，因此使用前无需进行任何设置。
开发
npm install
npm test
npm run build
请参阅 docs/OTC-API.md，了解经核实的数据范围，包括活动日历使用的美国 M-D-YYYY 日期路由（ISO 日期会被悄悄解析为 1970 年）、月份视图的截断情况，以及为何绝不硬编码 term id。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。