Grassy Knees

Grassy Knees MCP サーバー

ウェブサイト：https://grassyknees.com

AI アシスタントが 「今週末、デンバーで子どもと何ができますか？」 のような質問に、Grassy Knees の実際の掲載情報を使って回答できる、小規模な読み取り専用の Model Context Protocol サーバーです。Grassy Knees は、米国の42の都市圏における子ども向け・家族向けのイベント、クラス、施設を掲載する無料のディレクトリです。各掲載情報は主催者自身のページをもとに調査され、最終確認日が表示されます。

各検索結果には、grassyknees.com の掲載ページ URL、主催者の公式リンク、最終確認日が含まれます。各呼び出しで返される掲載情報は最大20件です。

プロンプトの例

• 「今週末、デンバーで子どもと何ができますか？」
• 「ワシントンD.C.で、4歳児向けの無料の催しを今後7日間で探しています。」
• 「土曜日にシアトルで、10歳児向けのSTEMイベントはありますか？」
• 「シカゴ近郊でアイススケートができる場所はどこですか？」
• 「オースティンで子ども向けのハロウィーンイベントを探しています。」
• 「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	1つの都市圏を検索します。フィルター：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を指定して、1件の掲載情報の詳細を取得します。スケジュール、今後の日程、会場、対象年齢、料金、登録リンク、最終確認日が含まれます。
seasonal_guide	都市圏別のハロウィーン、クリスマス（イルミネーションとホリデーイベント）、アイススケート、イースターのガイド、または全都市圏の概要を、max_chars（デフォルトは8,000）に収まるよう調整した Markdown で取得します。

日付は各都市圏の現地時間です。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 の公開エンドポイントを、一度に1件ずつ読み取り専用で呼び出します。

• 検索には GET /api/activities?city=<metro>&fields=list を使用します（1つの都市圏の最新の一覧を取得し、ローカルで絞り込んで最大20件に制限します）。
• get_activity には GET /api/activities?ids=<id> を使用します。
• seasonal_guide にはサイトの Markdown ページ（/<metro>/<season>.md）を使用します。

レスポンスはメモリ内に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。検索結果を表示する際は、掲載ページへのリンクを付け、最終確認日を記載してください。内容が変更されている場合があるため、出かける前に主催者の公式ページで確認してください。

ライセンス

このサーバーのコードは MIT ライセンスです。掲載データの権利は Grassy Knees に帰属し、一括コピーではなく検索での利用を目的として提供されています。