OnlineAfspraken Slots

OnlineAfspraken slots MCP

アカウントなしで、公開されている OnlineAfspraken ウィジェットの URL から空き枠を読み取ります。 このローカル MCP サーバーは空き状況の読み取りのみを行い、予約はできません。

はじめに

Python 3.10 以降と MCP クライアントが必要です。以下のコマンドは Unix シェル（macOS または Linux）を使用します。

1. このリポジトリをダウンロードするか、クローンします。

2. ディレクトリ内で、パッケージとその依存関係をインストールします。

   sh setup.sh
   

3. 以下の例のいずれかを使って、MCP クライアントにサーバーを登録します。 /absolute/path/to/onlineafspraken-slots-mcp をダウンロードしたコピーの フルパスに置き換えてください。

4. 新しいチャットを開始し、公開されている OnlineAfspraken ウィジェットの URL を入力します。たとえば、「このウィジェットで今日利用できる時間を表示してください：[ウィジェットの完全な URL をここに貼り付け]」のように入力します。

OnlineAfspraken ウィジェットを 1 つ埋め込んでいる、公開予約ページの 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 を自動検出するには、その URL がスクリプト、iframe、またはリンクに含まれている必要があります。空き枠は、検索から予約までの間に変更されることがあります。

ライセンス

MIT

リリースの公開

メンテナー向け：pyproject.toml と server.json のバージョンを同期してください。最初のリリースを公開するには、以下の値を使って保留中の PyPI Trusted Publisher を設定してください。

PyPI フィールド	値
PyPI プロジェクト名	onlineafspraken-slots-mcp
所有者	RichieB2B
リポジトリ	onlineafspraken-slots-mcp
ワークフロー	publish-pypi.yml
環境	pypi

次に、v0.1.0 のタグを付けて GitHub リリースを公開します。リリースワークフローは、ディストリビューションをビルドして検証し、Trusted Publishing を通じて PyPI にアップロードしたうえで、GitHub OIDC を通じて対応するバージョンを公式 MCP Registry に公開します。

公式 MCP Registry ガイドでは、公開プロセスについて説明しています。レジストリは、上記の mcp-name マーカーと PyPI リリースに含まれる README の内容を照合します。