OnlineAfspraken Slots

OnlineAfspraken 时段 MCP

无需账户，即可通过公开的 OnlineAfspraken 小组件 URL 读取可用时段。 此本地 MCP 服务仅读取可用时段，无法进行预约。

开始使用

你需要 Python 3.10 或更高版本以及一个 MCP 客户端。以下命令适用于 Unix shell（macOS 或 Linux）。

1. 下载或克隆此仓库。

2. 在其目录中安装软件包及其依赖项：

   sh setup.sh
   

3. 使用以下示例之一在 MCP 客户端中注册此服务。 将 /absolute/path/to/onlineafspraken-slots-mcp 替换为 你下载的副本的完整路径。

4. 开始新的聊天，并提供公开的 OnlineAfspraken 小组件 URL。例如：“显示此小组件今天的可用时段：[在此粘贴完整的小组件 URL]。”

你也可以传入嵌入了一个 OnlineAfspraken 小组件的公开预约页面 URL。如果页面包含多个小组件，请使用你想要的那个小组件的直接 URL。

连接 MCP 客户端

Codex

codex mcp add onlineafspraken-slots -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
codex mcp list

Claude Code

claude mcp add --scope user --transport stdio onlineafspraken-slots -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
claude mcp list

用户级配置会使此服务在你的所有 Claude Code 项目中可用。如需了解其他配置范围，请参阅 Claude Code MCP 文档。

Claude Desktop

在 Claude Desktop 配置的 mcpServers 下添加此条目，然后重启 Claude Desktop：

{
  "mcpServers": {
    "onlineafspraken-slots": {
      "command": "/absolute/path/to/onlineafspraken-slots-mcp/run.sh"
    }
  }
}

如果你已有 mcpServers 对象，只需将 onlineafspraken-slots 条目添加到其中。Claude Desktop 本地服务指南介绍了如何管理本地服务并检查其连接状态。

OpenCode

opencode mcp add onlineafspraken-slots --global -- /absolute/path/to/onlineafspraken-slots-mcp/run.sh
opencode mcp list

全局选项会使此服务在每个 OpenCode 项目中可用。如需了解项目专属配置，请参阅 OpenCode MCP 文档。

首次发布到 PyPI 后，支持软件包运行器的客户端可以直接从该软件包运行 onlineafspraken-slots-mcp 命令，而不必使用本地检出副本。

工具输入

此服务提供 get_available_slots：

输入	必填	含义
booking_page	是	公开 OnlineAfspraken 小组件或嵌入了该小组件的页面的完整 HTTPS URL。
date_iso	否	YYYY-MM-DD 格式的日期。默认为 Europe/Amsterdam 时区的今天。
room	否	预约类型名称中的一部分，用于筛选结果。

结果包括预约类型名称、可用的开始时间、日期、时区以及查询可用时段的时间。room 输入以原始用例命名，但适用于任何预约类型。

限制

此服务使用小组件公开但未公开文档的读取接口。服务提供方的变更可能需要更新代码。若要自动发现小组件 URL，预约页面必须在脚本、iframe 或链接中公开该 URL。可用时段可能会在查询后、预约前发生变化。

许可证

MIT

发布版本

维护者须知：确保 pyproject.toml 和 server.json 中的版本一致。要发布首个版本，请使用以下值配置待发布的 PyPI 可信发布者：

PyPI 字段	值
PyPI 项目名称	onlineafspraken-slots-mcp
所有者	RichieB2B
仓库	onlineafspraken-slots-mcp
工作流	publish-pypi.yml
环境	pypi

然后发布一个标记为 v0.1.0 的 GitHub 版本。发布工作流会构建并检查发行包，通过可信发布将其上传到 PyPI，并通过 GitHub OIDC 将对应版本发布到官方 MCP Registry。

官方 MCP Registry 指南介绍了发布流程。Registry 会检查上方的 mcp-name 标记是否与 PyPI 发行包中包含的 README 相符。