Surf MCP Server 使用说明

项目简介

Surf MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它通过调用 Storm Glass API 获取潮汐数据，并向 LLM 客户端提供潮汐信息查询工具。用户可以通过指定经纬度和日期，获取详细的潮汐信息，包括高潮和低潮时间、潮汐高度以及潮汐站点的相关信息。这个工具特别适用于需要潮汐信息的应用场景，例如冲浪、航海等。

主要功能点

潮汐信息查询: 根据用户提供的经纬度和日期，查询并返回详细的潮汐数据。
全球范围支持: 支持查询全球任意地点的潮汐信息。
指定日期查询: 允许用户查询特定日期的潮汐数据。
详细潮汐数据: 返回包括潮汐类型（高潮/低潮）、潮汐高度、潮汐发生时间（UTC）以及潮汐站点的名称和距离信息。
错误处理: 具备完善的错误处理机制，能够应对 API 请求失败、无效坐标、API 密钥缺失等问题。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆 Surf MCP Server 仓库到本地：

git clone https://github.com/ravinahp/surf-mcp.git
cd surf-mcp

安装依赖: 项目使用 'uv' 进行依赖管理。请确保您已安装 'uv'。在仓库根目录下执行以下命令安装项目依赖：
```
uv sync
```
获取 Storm Glass API 密钥:
- 访问 Storm Glass 官网并注册账号。
- 登录后，在您的账户仪表板中找到 API 密钥。
- 免费账户有请求次数限制，请根据您的需求选择合适的套餐。

服务器配置

要将 Surf MCP Server 配置为 MCP 服务器，您需要在您的 MCP 客户端（例如 Claude 桌面应用）的配置文件中添加服务器信息。

编辑 MCP 客户端配置文件: 找到 MCP 客户端的配置文件。对于 Claude 桌面应用，配置文件通常位于：
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'

添加服务器配置: 在 JSON 配置文件中添加以下配置代码块。请根据您的实际情况修改 'args' 中的仓库路径和 'env' 中的 API 密钥。

{
    "surf-mcp": { // 服务器名称，自定义，用于在客户端中识别和调用
        "command": "uv", // 启动服务器的命令，这里使用 uv
        "args": [ // 传递给启动命令的参数列表
            "--directory",
            "/Users/YOUR_USERNAME/Code/surf-mcp", //  ⚠️  请替换为 Surf MCP Server 仓库在您电脑上的实际路径
            "run",
            "surf-mcp" // 运行名为 surf-mcp 的应用
        ],
        "env": { // 环境变量配置
            "STORMGLASS_API_KEY": "your_api_key_here" //  ⚠️  请替换为您从 Storm Glass 官网获取的 API 密钥
        }
    }
}

重要提示:

请将 '"surf-mcp"' 替换为您希望在客户端中显示的服务器名称。
请务必将 '"/Users/YOUR_USERNAME/Code/surf-mcp"' 替换为 Surf MCP Server 仓库在您电脑上的 实际绝对路径。
请务必将 '"your_api_key_here"' 替换为您从 Storm Glass 官网获取的 API 密钥。

基本使用方法

配置完成后，启动您的 MCP 客户端。在客户端中，您可以使用自然语言指令来调用 'surf-mcp' 服务器提供的 'get_tides' 工具。例如，您可以向 Claude 提问：

请查询 2024-07-20 悉尼 (latitude=-33.8688, longitude=151.2093) 的潮汐信息

MCP 客户端会将您的请求转发给 Surf MCP Server，服务器会调用 Storm Glass API 获取潮汐数据，并将格式化后的结果返回给客户端，最终呈现给您。

关键词