冲浪MCP服务器
MCP服务器适用于冲浪和上网的人。
图表
视频演示
https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed
特性
- 使用纬度和经度获取任何位置的潮汐信息
- 支持特定日期的潮汐查询
- 详细的潮汐数据，包括高潮/低潮和站信息
- 自动时区处理（UTC）
先决条件
- Python 3.x
- Storm Glass API密钥
获取Storm Glass API密钥
- 访问 风暴玻璃
- 点击“免费试用”或“登录”创建帐户
- 注册后，您将收到您的API密钥
API使用限制说明：
- 免费等级：每天10个请求
- 可用付费计划：
- 小额：500次请求/天（19欧元/月） - 中等：5000次请求/天（49欧元/月） - 大型：25000个请求/天（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 - 窗户：
%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检查器。
您可以使用以下命令启动MCP检查器：
npx @modelcontextprotocol/inspector uv --directory /path/to/surf-mcp run surf-mcp启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。
检查员提供：
- 实时请求/响应监控
- 输入/输出验证
- 误差跟踪
- 性能指标
用法
该服务提供了一个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用例
示例1：寻找最佳冲浪时间
您可以使用此工具确定您最喜欢的海滩和最近的车站的最佳冲浪时间。一般来说，最佳的冲浪条件是在涨潮前约2小时的涨潮期间。
示例提示克劳德：
注：不同的海滩可能因其特定的地理位置和破口类型而具有不同的最佳潮汐条件。该工具还提供了应与潮汐信息一起考虑的站距离信息。（即，站距离越长，不准确的变化就越大——你也可以在提示时向克劳德询问）。
错误处理
该服务包括强大的错误处理功能，用于：
- API请求失败
- 坐标无效
- 缺少API密钥或密钥无效
- 网络超时
