🗑️ Reading Bin Collections MCP Server

🗑️ Reading Bin Collections MCP サーバー

Reading Borough Council の家庭ごみ収集日を取得する、MCP 準拠のツールです。
Claude とシームレスに連携できるように構築されています。

---

🔧 できること

この MCP サーバーを使うと、次のような質問ができます。

「51 Gosbrook Road, RG48BN のごみ収集日はいつですか？」

…Claude 内で直接質問できます。Reading Borough Council の API を使って郵便番号と番地を検索し、次回以降の収集日を返します。

---

🚀 クイックスタート

1. リポジトリをクローンする

git clone https://github.com/vaughanc/collections.git

2. UV をインストールする

curl -LsSf https://astral.sh/uv/install.sh | sh

uv コマンドが認識されるように、作業後に必ずターミナルを再起動してください。

3. 仮想環境を作成する

uv init collections
uv venv                                                   
source .venv/bin/activate
uv run fastmcp install --with uvicorn --with requests collections.py

インストールコマンドによって、Claude が MCP サーバーを検出するための設定が作成されます。

次のファイルで確認できます。

cat  ~/Library/Application\ Support/Claude/claude_desktop_config.json 
{
  "mcpServers": {
    "Reading Bin Collections Tool": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "requests",
        "--with",
        "uvicorn",
        "fastmcp",
        "run",
        "/Users/chris/Documents/Code/collections/collections.py"
      ]
    }
    }
  }

Claude を起動すると、次のように表示されます。

📬 裏側で使われている API

このツールは、主に次の 2 つのリクエストを実行します。

1. 住所の UPRN を取得

エンドポイント： https://www.reading.gov.uk/api/address-search パラメーター： postcode 用途：指定した道路名と郵便番号に対応する UPRN を特定します。

2. 収集スケジュールを取得

エンドポイント： https://www.reading.gov.uk/api/bin-collections パラメーター： uprn 用途：ごみの種類と収集日（リサイクルごみ、生ごみ、家庭ごみなど）を取得します。

📸 スクリーンショット

こちらのクイックスタートガイドを参考に、作業を始めるための背景情報を得ました。

https://modelcontextprotocol.io/quickstart/server

NPM などの依存関係を解決するために brew を使った可能性もありますが、記憶が定かではありません。

https://brew.sh/