mcpField
S
Surt de Casa (surtdecasa.cat)

Surt de Casa (surtdecasa.cat)

远程服务
github.com游戏娱乐05 周前更新

关于 Surt de Casa (surtdecasa.cat)

Surt de Casa 的 MCP 服务为客户端提供加泰罗尼亚本地文化活动、电影排片和城镇查询,适合查找地区活动与影院信息。支持远程 HTTP 和本地 stdio 两种连接方式。

主要功能

  1. 01按地区、类别、日期筛选活动
  2. 02查看活动详情与链接
  3. 03查询每周电影排片
  4. 04自动补全城镇名称

适用场景

  1. 01按周末或日期查找文化活动
  2. 02查看活动地点、价格和主办方
  3. 03查询本周电影及海报链接

MCP 相关

该 MCP 服务向客户端开放活动搜索、活动详情、电影排片和城镇查询工具。可通过远程 Streamable HTTP 或本地 stdio 连接。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://surtdecasa-mcp.peremontpeo.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

4
参数类型必填说明
fistring否结束日期 dd/mm/yyyy(仅传入开始日期时,范围为一年)
zonaarray否要包含的区域
inicistring否开始日期 dd/mm/yyyy(优先于日历快捷选项)
tipusarray否特殊标签
poblaciostring否城镇名称(必须完全匹配;查询 poblacions 以查找)
calendarienum否日期快捷选项avui | dema | cap-de-setmana
categoriaarray否要包含的类别

详细介绍

surtdecasa-mcp

为 surtdecasa.cat 提供的 MCP 服务。该网站是本地文化资讯平台。可通过任何 MCP 客户端直接访问文化活动日程、电影排片信息和城镇搜索器。

提供两种模式:

  • 远程:通过 Streamable HTTP 访问 https://surtdecasa-mcp.peremontpeo.workers.dev/mcp(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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。