关于 Surt de Casa (surtdecasa.cat)
Surt de Casa 的 MCP 服务为客户端提供加泰罗尼亚本地文化活动、电影排片和城镇查询,适合查找地区活动与影院信息。支持远程 HTTP 和本地 stdio 两种连接方式。
主要功能
- 01按地区、类别、日期筛选活动
- 02查看活动详情与链接
- 03查询每周电影排片
- 04自动补全城镇名称
适用场景
- 01按周末或日期查找文化活动
- 02查看活动地点、价格和主办方
- 03查询本周电影及海报链接
MCP 相关
该 MCP 服务向客户端开放活动搜索、活动详情、电影排片和城镇查询工具。可通过远程 Streamable HTTP 或本地 stdio 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://surtdecasa-mcp.peremontpeo.workers.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http pmontp19-surtdecasa https://surtdecasa-mcp.peremontpeo.workers.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"pmontp19-surtdecasa":{"serverUrl":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| fi | string | 否 | 结束日期 dd/mm/yyyy(仅传入开始日期时,范围为一年) |
| zona | array | 否 | 要包含的区域 |
| inici | string | 否 | 开始日期 dd/mm/yyyy(优先于日历快捷选项) |
| tipus | array | 否 | 特殊标签 |
| poblacio | string | 否 | 城镇名称(必须完全匹配;查询 poblacions 以查找) |
| calendari | enum | 否 | 日期快捷选项avui | dema | cap-de-setmana |
| categoria | array | 否 | 要包含的类别 |
详细介绍
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
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。