mcpField
C
charlotteonthecheap-mcp

charlotteonthecheap-mcp

ローカル
github.com/chrischallゲーム・エンタメ04 日前に更新
リポジトリ

charlotteonthecheap-mcp について

charlotteonthecheap-mcpは、On the Cheapネットワークの無料・低価格イベント、セール情報、地域ガイドを読み取り専用で提供します。米国の14都市のサイトに対応し、呼び出しごとにサイトを指定します。認証情報や追加設定は不要です。

主な機能

  1. 01日ごとのイベントの時間、価格、会場を表示
  2. 02無料イベントの絞り込み
  3. 03テキスト、カテゴリ、場所、日付による記事検索
  4. 04記事全文の閲覧とカテゴリや場所の参照
  5. 0514都市と全国サイトの選択
  6. 06指定による終了済みセールの検索

活用シーン

  1. 01指定した都市と日付の無料イベント探し
  2. 02複数都市の地域イベントの比較
  3. 03テーマや場所からのセール情報検索
  4. 04地域ガイドの閲覧や過去記事の確認

MCP 対応

読み取り専用のMCPツールで、On the Cheapネットワークの公開サイトを検索できます。多くのツールでは、対象の都市または全国サイトのキー指定が必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "chrischall-charlotteonthecheap": {
      "command": "npx",
      "args": [
        "-y",
        "charlotteonthecheap-mcp"
      ],
      "env": {
        "COTC_BASE_URL": "<COTC_BASE_URL>"
      }
    }
  }
}
起動コマンドnpx -y charlotteonthecheap-mcp
設定が必要な環境変数
COTC_BASE_URLOptional override for the Charlotte On The Cheap base URL. The site is public; no credentials are required.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmcharlotteonthecheap-mcp0.1.1

ツール

7

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
tagintegerいいえタグ ID
pageintegerいいえ1 始まりのページ番号
afterstringいいえこの日付以降に公開された投稿のみ
querystringいいえ全文検索。例："free museum day"
beforestringいいえこの日付以前に公開された投稿のみ
compactbooleanいいえ完全なレコードではなく簡潔な要約を返します（デフォルトは true）
categoryintegerいいえcotc_list_categories のカテゴリ ID
locationintegerいいえcotc_list_locations の場所 ID
per_pageintegerいいえ1 ページあたりの結果数（最大 100 件）
include_expiredbooleanいいえ終了／期限切れの特典を含めます（デフォルトは 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

都市の選択

1つのサーバーでネットワーク全体を利用できます。すべてのツールで読み込み先の都市を指定する site 引数が必要です。デフォルト値はなく、設定手順もありません。

キーサイト地域
charlotteCharlotte On The CheapCharlotte, NC
denverMile High on the CheapDenver, CO
atlantaAtlanta on the CheapAtlanta, GA
chicagoChicago on the CheapChicago, IL
columbusColumbus on the CheapColumbus, OH
seattleGreater Seattle on the CheapSeattle–Tacoma
kansascityKansas City on the CheapKansas City
miamiSouth Florida on the CheapMiami / Broward / Palm Beach
orlandoOrlando on the CheapOrlando, FL
portlandPortland Living on the CheapPortland, OR
richmondRVA on the CheapRichmond, VA
southernmaineSouthern Maine on the CheapSouthern Maine
triangleTriangle on the CheapRaleigh / Durham / Chapel Hill
nationalLiving On The Cheap全米のお得情報（地域イベントカレンダーなし）

milehigh、raleigh、rva、kc、southflorida などの一般的な別名も使えます。 otc_list_sites で同じ一覧を確認できます。

意図的に site を必須にしており、デフォルト値はありません。サーバーがひそかに別の都市へ切り替わると、デンバーについての質問にシャーロットのデータで回答し、誤りに気づけないおそれがあるためです。無効なキーを指定すると、利用可能なキーを示して拒否されます。

ツール

すべてのツールは読み取り専用です。otc_list_sites 以外のすべてのツールで、site 引数が必須です。イベント関連の2つのツールでは、地域イベントカレンダーがない national は拒否されます。ただし、その他のツールでは引き続き検索できます。

ツール説明
otc_list_events指定した日のイベントをすべて表示します。時刻、料金、会場を確認できます。free_only を指定すると、無料の掲載情報に絞り込めます。デフォルトは今日です。
otc_events_month_overview月の日ごとの件数を表示し、最もにぎわう日を探せます。各日の一覧はプレビューであり、実際の件数は total に表示されます。
otc_search_postsテキスト、カテゴリー、場所、期間を指定して記事を検索します。デフォルトでは概要を簡潔に表示します。
otc_get_post記事を1件、読みやすいテキストまたは生の HTML で取得します。ID、スラッグ、URLを指定できます。
otc_list_categoriesカテゴリー ID と投稿件数を表示します。トピックで検索を絞り込むときに使えます。
otc_list_locations地域 ID と投稿件数を表示します。地理的な条件で検索を絞り込むときに使えます。
otc_list_sitesネットワーク内の都市と、それぞれの site キーを表示します。引数は不要です。
otc_healthcheckサイトへの接続を確認します。失敗時、error.kind は edge_blocked、http、timeout、transport のいずれかになります。
使用例

今週土曜日にシャーロットで無料のイベントはありますか？

8月にレイク・ノーマンで開催される子ども向けイベントを探して

来週末にデンバーとポートランドで楽しめる無料のアクティビティを比較して

知っておくべきことが2つあります

終了したセールはデフォルトで除外されます。 各サイトでは期限切れのオファーを expired カテゴリに分類しているため、検索ではスキップされ、すでに存在しないセールは表示されません。アーカイブを検索するには、include_expired: true を渡してください。カテゴリの ID はサイトごとに異なるため、リクエスト時にスラッグから解決します。ID をハードコードすると、ほかのサイトではフィルターがひそかに無効になります。

カテゴリ ID と地域 ID はサイトごとに異なります。 各サイトは個別の WordPress インストールなので、ID 13 はサイトごとに異なるカテゴリを指します。ID は、検索対象と同じ site に対して解決してください。別の都市の ID を使うと、エラーになるのではなく、無関係な項目で絞り込まれます。

月間概要はプレビューであり、件数は正確です。 カレンダーには、1日あたり最大4件のリスティングが表示されます。otc_events_month_overview はプレビューとともに、各日の正確な合計件数を報告します。全スケジュールを確認するには、日付を指定して otc_list_events を呼び出してください。

設定

ありません。都市は環境変数ではなく、呼び出しごとに指定する site 引数です。そのため、使用前に設定することはありません。

開発

npm install
npm test
npm run build

検証済みのデータ範囲については、docs/OTC-API.md を参照してください。これには、イベントカレンダーの日付を米国形式の M-D-YYYY でルーティングする仕組み（ISO 日付はひそかに1970年として解析されます）、月間ビューの省略、用語 ID をハードコードしない理由が含まれています。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。