Grassy Knees

Grassy Knees MCP 服务

网站：https://grassyknees.com

一个小型、只读的 Model Context Protocol 服务，可让 AI 助手使用 Grassy Knees 上的真实活动信息，回答诸如 “这个周末在 Denver 可以带孩子做些什么？” 之类的问题。Grassy Knees 是一个免费目录，收录了美国 42 个都市圈的儿童和家庭活动、课程及场所。每条信息都根据组织方自己的页面进行核实，并显示上次核实日期。

每条结果都包含该条目的 grassyknees.com 页面 URL、组织方的官方链接及上次核实日期。每次调用最多返回 20 条信息。

示例提示词

• “这个周末在 Denver 可以带孩子做些什么？”
• “未来 7 天内，Washington, DC 有哪些适合 4 岁儿童的免费活动？”
• “周六在 Seattle 有适合 10 岁儿童的 STEM 活动吗？”
• “我们可以去 Chicago 附近哪里滑冰？”
• “Austin 有哪些适合儿童的万圣节活动？”
• “详细介绍一下 https://grassyknees.com/denver/activities/rock-creek-farm-pumpkin-patch-and-corn-maze--listing-69c7739ea9ac9cfaddb69622”

安装

需要 Node.js 20 或更高版本。无需 API 密钥。

Claude Desktop

将以下内容添加到 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "grassyknees": {
      "command": "npx",
      "args": ["-y", "grassyknees-mcp"]
    }
  }
}

Claude Code

claude mcp add grassyknees -- npx -y grassyknees-mcp

Cursor

将以下内容添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "grassyknees": {
      "command": "npx",
      "args": ["-y", "grassyknees-mcp"]
    }
  }
}

任何其他可运行 stdio 服务的 MCP 客户端也可以使用相同方式：命令为 npx -y grassyknees-mcp。

也可以使用 Docker：通过 docker build -t grassyknees-mcp . 构建镜像，并将 docker run -i --rm grassyknees-mcp 用作命令。

工具

工具	功能
list_metros	列出涵盖的 42 个都市圈，以及传递给其他工具的 id（例如 denver、new-york、washington-dc、dallas-fort-worth）和每个都市圈的页面 URL。
search_activities	搜索一个都市圈。筛选条件：when（today、tomorrow、this-weekend、next-7-days、next-30-days）或 start_date/end_date、kind（event、program、place、any）、free_only、age、category、query（关键词）、limit（1–20，默认值为 10）。按时间从近到远排序。
get_activity	根据 grassyknees.com URL 或 id 获取一个条目的完整详情：日程、即将举行的日期、场地、适合年龄、价格、报名链接及上次核实日期。
seasonal_guide	获取某个都市圈的万圣节、圣诞节（灯饰和节日活动）、滑冰或复活节指南，或所有都市圈的概览；内容为 Markdown，并截取至 max_chars（默认值为 8,000）。

日期采用相应都市圈的当地时间。this-weekend 指周五至周日，与网站 /<metro>/this-weekend 页面采用的时间范围相同。

示例对话

来自 npm run smoke，于 2026-10-28 对线上网站运行（内容已截短）：

tools: list_metros, search_activities, get_activity, seasonal_guide

=== search_activities {"metro":"denver","when":"this-weekend","limit":3}
60 events in Denver for this weekend (2026-10-30 to 2026-11-01); showing the first 3:

1. **[School's Out! Day: Pumpkins & Potions](https://grassyknees.com/denver/activities/school-s-out-day-pumpkins-and-potions--listing-023a33783babb5880fc24e03)**
   Fri, Oct 30 · 8:30 AM–3:30 PM · JCC Denver (Staenberg-Loup Jewish Community Center), 350 S. Dahlia St., Denver, CO 80246
   Ages 5+ · From $100 (...) · Arts & crafts · last checked 2026-10-14

2. **[Rock Creek Farm Pumpkin Patch and Corn Maze](https://grassyknees.com/denver/activities/rock-creek-farm-pumpkin-patch-and-corn-maze--listing-69c7739ea9ac9cfaddb69622)**
   Fri, Oct 30 · 9:30 AM–7:00 PM (also other dates) · Rock Creek Farm, 2005 S 112th St., Broomfield, CO 80020
   Farm admission applies to ages 4 & up · From $10 (...) · Outdoors · last checked 2026-10-28

3. **[JTML Hoppy Halloween Storytime](https://grassyknees.com/denver/activities/jtml-hoppy-halloween-storytime--listing-5ee8642f996422fe0023e407)**
   Fri, Oct 30 · 10:00 AM–11:00 AM · John Tomay Memorial Library, 605 6th Street, Georgetown, CO 80444
   Kids (event category) · Check price · Community · last checked 2026-10-14

More on grassyknees.com: https://grassyknees.com/denver/this-weekend

=== search_activities {"metro":"DC","when":"this-weekend","free_only":true,"limit":3}
20 events, free in Washington, DC for this weekend (2026-10-30 to 2026-11-01); showing the first 3:

1. **[Play Day in the Park at Black Hill Discovery Center](https://grassyknees.com/washington-dc/activities/play-day-in-the-park-at-black-hill-discovery-center--listing-c17ea7ba367fd70feca1648e)**
   Fri, Oct 30 · 11:00 AM–12:00 PM (also other dates) · Black Hill Discovery Center, 20926 Lake Ridge Drive, Boyds, MD 20841
   Ages 6 mos to 3 yrs · Free ($0.00) · Outdoors · last checked 2026-10-24
...

=== get_activity {"url_or_id":"https://grassyknees.com/denver/activities/school-s-out-day-pumpkins-and-potions--listing-023a33783babb5880fc24e03"}
# School's Out! Day: Pumpkins & Potions
- When: Fri, Oct 30 · 8:30 AM–3:30 PM
- Where: JCC Denver (Staenberg-Loup Jewish Community Center), 350 S. Dahlia St., Denver, CO 80246
- Official page: https://www.jccdenver.org/camps/schools-out-camp/
- Last checked: 2026-10-14
...

=== seasonal_guide {"season":"ice-skating","metro":"denver","max_chars":1500}
# Ice skating with kids in Denver
> 9 ice rinks, public skates, holiday skate nights and learn-to-skate classes for kids in the Denver–Aurora–Centennial area this winter, ...
[Trimmed to 1500 of 6484 characters. Full guide: https://grassyknees.com/denver/ice-skating (Markdown: https://grassyknees.com/denver/ice-skating.md)]

数据获取方式

只读访问 grassyknees.com 的公开端点，一次发送一个请求：

• GET /api/activities?city=<metro>&fields=list 用于搜索（一个都市圈当前的列表，在本地筛选，并将结果数限制为 20），
• GET /api/activities?ids=<id> 用于 get_activity，
• 网站的 Markdown 页面（/<metro>/<season>.md）用于 seasonal_guide。

响应会在内存中缓存 10 分钟，因此针对同一都市圈的后续问题不会再次发起请求。请求会发送 User-Agent: grassyknees-mcp/<version>。不会向网站写入任何内容，也不会发送个人数据。

设置 GRASSYKNEES_ORIGIN 可将服务指向其他部署（用于测试）。

开发

npm install
npm run build
npm run smoke            # calls each tool once against the live site (4 requests)
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

致谢

数据：Grassy Knees，grassyknees.com。展示结果时，请链接到该条目的 grassyknees.com 页面，并注明上次核实日期。详情可能会发生变化，出行前请在组织方的官方页面上确认。

许可证

此服务的代码采用 MIT 许可证。条目数据归 Grassy Knees 所有，仅供查询，不可批量复制。