Surt de Casa (surtdecasa.cat)

surtdecasa-mcp

s urtdecasa.cat の MCP サーバーです。身近な文化情報を扱うデジタルメディアです。あらゆる MCP クライアントから、文化イベント情報、映画上映情報、地域検索に直接アクセスできます。

2 つのモードで利用できます。

• リモート：https://surtdecasa-mcp.peremontpeo.workers.dev/mcp で Streamable HTTP（Cloudflare Workers、無料）
• ローカル：stdio で、コンピューター上で実行します

ツール

ツール	説明
cercar_agenda	地域、カテゴリー、種類（屋外、無料、夜間）、地域、日付（今日／明日／週末）、日付範囲で絞り込んでイベントを検索します
detall_esdeveniment	イベントの詳細情報をすべて表示します：日付、場所、地域、料金、主催者、説明、リンク
cartellera	今週の映画をリンクとポスター付きで表示します
poblacions	地域のオートコンプリート：poblacio フィルターで使用できる正確な名前を返します

設定

リモートクライアント（推奨）

{
  "mcp": {
    "surtdecasa": {
      "type": "remote",
      "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"
    }
  }
}

ローカルクライアント（stdio）

{
  "mcp": {
    "surtdecasa": {
      "type": "local",
      "command": ["node", "/ruta/a/surtdecasa-mcp/dist/index.js"]
    }
  }
}

開発

Node 20 以降が必要です。

npm install
npm run build      # typecheck (stdio + workers) i compilar dist/
npm run dev:cf     # wrangler dev local a http://localhost:8787/mcp
npm run deploy     # desplegar a Cloudflare Workers

構成：

• src/scraper.ts：surtdecasa.cat の HTTP クライアントと HTML パーサー（サーバー側でレンダリングされる Drupal 7）
• src/tools.ts：MCP ツールの登録（両方のトランスポートで共有）
• src/index.ts：ローカル stdio のエントリーポイント
• src/worker.ts：Cloudflare Workers のエントリーポイント（Streamable HTTP を使用する Durable Object）

注意事項

• サイトに公開 API はありません。サーバーは HTML を適切な方法でスクレイピングします（オンデマンドのリクエストは少数で、識別可能な User-Agent を使用）。
• 認証はありません。リモートエンドポイントは公開されています。自分でデプロイして使う場合は、トークンの追加を検討してください。
• 利用可能な地域：ebre、penedes、camp、emporda、ponent、girona、centre、pirineus、barcelona。

ライセンス

MIT