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 分

    请在仓库或注册中心条目中声明许可证。