Surt de Casa (surtdecasa.cat)

io.github.pmontp19由 GitHub 帳號 pmontp19 發布v0.1.1更新於 Oct 24, 2026

Servidor MCP per surtdecasa.cat: agenda cultural de Catalunya, cartellera de cinema i poblacions.

已驗證Streamable HTTP可網頁執行位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

針對 surtdecasa.cat 的 MCP 伺服器，讓助理搜尋加泰隆尼亞文化活動、每週電影時刻與城鎮名稱。

可以做什麼
  • 依地區、類別、類型、城鎮、日期或日期區間搜尋文化活動行程
  • 取得單一活動的完整資訊，包括日期、地點、價格、描述與連結
  • 列出本週電影時刻及連結與海報
  • 查詢城鎮篩選器所接受的確切城鎮名稱
適用情境
適合讓助理尋找加泰隆尼亞的在地去處：文化活動、週末安排，或電影院本週放映的片子，並從 surtdecasa.cat 取得詳細資料。
執行需求
提供遠端 Streamable HTTP 端點，不需帳號或金鑰。也可從原始碼以 Node 20 以上版本在本機以 stdio 執行。需要能連線至 surtdecasa.cat 的網路。
安裝前請注意
遠端端點公開且未經驗證，知道網址的人都能使用；README 建議自行部署時加上權杖。該網站沒有公開 API，伺服器以擷取 HTML 方式取得資料，結果取決於頁面結構。所有工具皆為唯讀。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Surt de Casa (surtdecasa.cat)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.pmontp19%2Fsurtdecasa-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "surt-de-casa-surtdecasa-cat": {
      "type": "http",
      "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"
    }
  }
}

README

surtdecasa-mcp

Servidor MCP per surtdecasa.cat, el digital de cultura de proximitat. Dona accés a l'agenda cultural, la cartellera de cinema i el cercador de poblacions directament des de qualsevol client MCP.

Disponible en dos modes:

  • Remot: Streamable HTTP a https://surtdecasa-mcp.peremontpeo.workers.dev/mcp (Cloudflare Workers, gratis)
  • Local: stdio, per executar-lo al teu ordinador

Eines

EinaDescripció
cercar_agendaCerca esdeveniments amb filtres: zona territorial, categoria, tipus (aire lliure, gratuït, nocturn), població, dies (avui/dema/cap de setmana) i rang de dates
detall_esdevenimentTota la informació d'un esdeveniment: dates, lloc, poblacions, preu, organitzador, descripció i enllaços
cartelleraPel·lícules de la setmana amb enllaç i cartell
poblacionsAutocomplete de poblacions: retorna els noms exactes que accepta el filtre poblacio

Configuració

Client remot (recomanat)

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

Client local (stdio)

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

Desenvolupament

Requereix Node 20+.

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

Estructura:

  • src/scraper.ts: client HTTP i parsers HTML de surtdecasa.cat (Drupal 7 renderitzat al servidor)
  • src/tools.ts: registre de les eines MCP (compartit entre els dos transports)
  • src/index.ts: entrada stdio local
  • src/worker.ts: entrada Cloudflare Workers (Durable Object amb Streamable HTTP)

Notes

  • El site no té API pública: el servidor fa scraping respectuós del HTML (poques peticions on-demand, User-Agent identificatiu).
  • Sense auth: l'endpoint remot és públic. Si el desplegues per al teu ús, considera afegir-hi un token.
  • Zones disponibles: ebre, penedes, camp, emporda, ponent, girona, centre, pirineus, barcelona.

Llicència

MIT

來源：README.md，提交 8b726ce

工具

4

cercar_agenda

Cercar a l'agenda

Cerca esdeveniments a l'agenda de surtdecasa.cat. Es pot filtrar per zona territorial, categoria, tipus (aire lliure, gratuït, nocturn), població, dies concrets (avui, dema, cap-de-setmana) o un rang de dates en format dd/mm/yyyy.

輸入參數fizonainicitipuspoblaciocalendaricategoria

detall_esdeveniment

Detall d'un esdeveniment

Retorna tota la informació d'un esdeveniment de l'agenda (dates, lloc, poblacions, preu, descripció, enllaços). Requereix la URL o ruta que retorna cercar_agenda.

輸入參數url必填

cartellera

Cartellera de cinema

Retorna les pel·lícules de la setmana a surtdecasa.cat amb el seu enllaç i cartell.

無需輸入參數。

poblacions

Cercar poblacions

Autocomplete de poblacions de surtdecasa.cat. Passa-hi un prefix o fragment de nom i retorna els noms exactes acceptats pel filtre poblacio de cercar_agenda.

輸入參數terme必填

版本歷史

2
  1. v0.1.1最新Sep 21, 2026
  2. v0.1.0Sep 19, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。