collections (Vaughanc)

🗑️ 读取仓位集合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/