使用说明

项目简介

Buienradar MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,它作为一个工具,可以为大型语言模型 (LLM) 提供实时的降水预报信息。该服务器集成了荷兰 Buienradar 提供的天气数据 API,能够根据用户提供的经纬度坐标,查询并返回未来两小时内的降水情况。通过这个服务器,LLM 可以获取地理位置相关的天气���下文信息,从而在对话或应用中更好地理解和回应用户关于天气方面的问题。

主要功能点

  • 降水预报查询: 提供 'get_precipitation_for' 工具,允许 LLM 查询指定位置未来两小时的降水预报。
  • 基于 Buienradar API: 数据来源于可靠的荷兰 Buienradar 天气服务。
  • MCP 协议支持: 遵循 MCP 协议标准,易于与支持 MCP 协议的 LLM 客户端集成。
  • 简单易用: 配置和使用过程简洁明了。

安装步骤

  1. 克隆仓库: 首先,将 Buienradar MCP Server 仓库克隆到本地:
    git clone https://github.com/wpnbos/buienradar-mcp-server
    cd buienradar-mcp-server
  2. 安装 Python 依赖 (uv): 确保你的系统已安装 Python 和 'uv'。 'uv' 是一个快速的 Python 包安装和虚拟环境管理工具。如果尚未安装 'uv',请根据其官方文档进行安装。
  3. 安装项目依赖: 在项目根目录下,使用 'uv pip install .' 命令安装项目依赖。

服务器配置

要将 Buienradar MCP Server 集成到 MCP 客户端(例如 Claude for Desktop),你需要配置客户端的 MCP 服务器设置。以下是配置信息,你需要将其添加到客户端的配置文件中。

针对 Claude for Desktop 的配置示例 (claude_desktop_config.json):

{
    "mcpServers": {
        "precipitation": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/buienradar-mcp-server",
                "run",
                "server.py"
            ]
        }
    }
}

配置参数说明:

  • '"precipitation"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • '"command": "uv"': 启动服务器的命令。这里使用 'uv' 命令来运行 Python 脚本。 注意: 你可能需要提供 'uv' 可执行文件的完整路径,如果客户端无法直接找到 'uv' 命令。 可以使用 'which uv' (MacOS/Linux) 或 'where uv' (Windows) 命令查找 'uv' 的完整路径。
  • '"args": [...]"': 传递给 'uv' 命令的参数列表。
    • '"--directory"': 指定服务器代码所在的目录。
    • '"/ABSOLUTE/PATH/TO/PARENT/FOLDER/buienradar-mcp-server"': 请务必替换为 Buienradar MCP Server 仓库在你的电脑上的绝对路径。 你需要将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/buienradar-mcp-server' 替换为实际的路径,例如 '/Users/yourusername/Documents/buienradar-mcp-server' 或 'C:\Users\YourUsername\Documents\buienradar-mcp-server'。
    • '"run"': 'uv run' 命令用于运行 Python 脚本。
    • '"server.py"': 指定要运行的服务器脚本文件。

配置文件的位置:

  • MacOS/Linux: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '$env:AppData\Claude\claude_desktop_config.json' (可以在 PowerShell 中使用 'code $env:AppData\Claude\claude_desktop_config.json' 命令打开)

配置完成后,重启你的 MCP 客户端 (例如 Claude for Desktop) 以使配置生效。

基本使用方法

配置完成后,你就可以在 MCP 客户端中使用了。例如,在 Claude 中,你可以直接询问关于天气的相关问题,Claude 应该能够调用 Buienradar MCP Server 提供的工具来获取降水预报信息。

例如,你可以这样提问:

Will there be any rain soon in Amsterdam? (阿姆斯特丹很快会下雨吗?)

客户端会将地理位置信息(例如 "Amsterdam")传递给 Buienradar MCP Server,服务器会查询 Buienradar API 并返回该位置的降水预报,最终 LLM 会根据返回的信息给出回答。

注意: 你需要确保你的 MCP 客户端支持工具调用,并已正确配置 Buienradar MCP Server。

信息

分类

网页与API