MCP 服务器

Surf MCP Server

根据经纬度获取任何地点的潮汐信息，提供详细的潮汐数据，包括高/低潮以及站点信息，并自动处理 UTC 时区。

Tools

get_tides

Get tide information for a specific location and date. Args: latitude: Float value representing the location's latitude longitude: Float value representing the location's longitude date: Date string in YYYY-MM-DD format Returns: Formatted string containing tide information and station details

README

Surf MCP 服务器

为冲浪爱好者和网络用户提供的 MCP 服务器。

示意图

Letter Dot Grid - 5 dpi

视频演示

https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed

功能

使用纬度和经度获取任何位置的潮汐信息
支持特定日期的潮汐查询
详细的潮汐数据，包括高/低潮和站点信息
自动时区处理 (UTC)

前提条件

Python 3.x
Storm Glass API 密钥

获取您的 Storm Glass API 密钥

访问 Storm Glass
点击 "Try for Free" 或 "Sign In" 创建一个帐户
注册后，您将收到您的 API 密钥

关于 API 使用限制的说明：

免费层级：每天 10 个请求
付费计划：
- 小型：每天 500 个请求（19 欧元/月）
- 中型：每天 5000 个请求（49 欧元/月）
- 大型：每天 25,000 个请求（129 欧元/月）
- 企业级：提供定制计划

根据您的使用需求选择一个计划。免费层级适合测试和个人使用。

安装

克隆存储库：

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

使用 uv 安装依赖项：

uv sync

注意：我们使用 uv 而不是 pip，因为该项目使用 pyproject.toml 进行依赖管理。

配置为 MCP 服务器

要将此工具添加为 MCP 服务器，您需要修改您的 Claude 桌面配置文件。此配置包括您的 Storm Glass API 密钥，因此您无需单独设置。

配置文件的位置取决于您的操作系统：

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

将以下配置添加到您的 JSON 文件：

{
    "surf-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/YOUR_USERNAME/Code/surf-mcp",
            "run",
            "surf-mcp"
        ],
        "env": {
            "STORMGLASS_API_KEY": "your_api_key_here"
        }
    }
}

⚠️ 重要提示：

将 YOUR_USERNAME 替换为您实际的系统用户名
将 your_api_key_here 替换为您实际的 Storm Glass API 密钥
确保目录路径与您的本地安装匹配

部署

构建

要准备软件包：

同步依赖项并更新锁定文件：

uv sync

构建软件包：

uv build

这将在 dist/ 目录中创建分发包。

调试

由于 MCP 服务器通过 stdio 运行，因此调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

您可以使用以下命令启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/surf-mcp run surf-mcp

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

Inspector 提供：

实时请求/响应监控
输入/输出验证
错误跟踪
性能指标

用法

该服务提供了一个 FastMCP 工具来获取潮汐信息：

@mcp.tool()
async def get_tides(latitude: float, longitude: float, date: str) -> str:
    """Get tide information for a specific location and date."""

参数：

latitude: 表示位置纬度的浮点值
longitude: 表示位置经度的浮点值
date: YYYY-MM-DD 格式的日期字符串

示例响应：

Tide Times:
Time: 2024-01-20T00:30:00+00:00 (UTC)
Type: HIGH tide
Height: 1.52m

Time: 2024-01-20T06:45:00+00:00 (UTC)
Type: LOW tide
Height: 0.25m

Station Information:
Name: Sample Station
Distance: 20.5km from requested location