垃圾收集查询工具

一个符合MCP标准的工具,用于从Reading Borough Council获取家庭垃圾收集日期,支持与Claude无缝集成。

  • by vaughanc
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vaughanc/collections

使用说明

🗑️ 读取仓位集合MCP服务器

雷丁市议会发布了一个符合MCP标准的家庭垃圾收集工具。
专为与Claude无缝集成而打造。


🔧 它做什么

此MCP服务器允许您提出以下问题:

“我在RG48BN Gosbrook路51号的垃圾箱收藏了什么?”

直接在克劳德。它通过雷丁市议会的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

install命令将创建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幕后

此工具发出两个关键请求:

  1. 获取地址UPRN

端点:https://www.reading.gov.uk/api/address-search 参数:邮政编码 用途:解析给定街道/邮政编码的UPRN。

  1. 提取收集计划

端点:https://www.reading.gov.uk/api/bin-collections 参数:uprn 用途:检索垃圾箱类型和日期(回收、食物垃圾、生活垃圾等)

📸 截图

我使用了这个快速入门指南来提供入门的背景。

https://modelcontextprotocol.io/quickstart/server

我也可能用brew来解决一些依赖关系,比如NPM,但记不清了。

https://brew.sh/