Surf MCP Server
浏览 MCP 服务器
MCP 服务器适用于冲浪和上网的人。
图表
Related MCP server: BC Water Tides MCP Server
视频演示
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 欧元/月)
大型:25,000 个请求/天(129 欧元/月)
企业:提供定制计划
根据您的使用需求选择套餐。免费套餐适合测试和个人使用。
安装
克隆存储库:
git clone https://github.com/ravinahp/surf-mcp.git
cd surf-mcp使用 uv 安装依赖项:
uv sync注意:由于该项目使用pyproject.toml进行依赖管理,因此我们使用uv而不是 pip。
配置为 MCP 服务器
要将此工具添加为 MCP 服务器,您需要修改 Claude 桌面配置文件。此配置包含您的 Storm Glass API 密钥,因此您无需单独设置。
配置文件位置取决于您的操作系统:
MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%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启动后,检查器将显示一个 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 小时。
给 Claude 的示例提示:
注意:不同的海滩可能因其特定的地理位置和浪涌类型而具有不同的最佳潮汐条件。此工具还提供站点距离信息,应与潮汐信息一起考虑。(例如,站点距离越长,误差变化越大——您也可以在提示时向 Claude 询问此信息)。
错误处理
该服务包括针对以下方面的强大错误处理:
API 请求失败
无效坐标
API 密钥缺失或无效
网络超时
Available Tools
1 toolget_tidesB
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
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | Yes | ||
| longitude | Yes | ||
| date | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions what the tool returns ('Formatted string containing tide information and station details'), it lacks critical behavioral context such as rate limits, error conditions, authentication requirements, or whether this is a read-only operation. The description provides basic output format but misses important operational details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is perfectly structured and concise. It begins with a clear purpose statement, then provides organized sections for arguments and returns with specific formatting details. Every sentence adds value, and the information is front-loaded with the most important details first.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 3-parameter tool with no annotations and no output schema, the description provides adequate but incomplete coverage. It explains parameters well and gives output format, but lacks behavioral context like error handling, rate limits, or authentication requirements. The absence of an output schema means the description should ideally provide more detail about the return structure beyond 'formatted string.'
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description provides excellent parameter semantics despite 0% schema description coverage. It clearly explains each parameter's purpose: 'Float value representing the location's latitude/longitude' and 'Date string in YYYY-MM-DD format.' This fully compensates for the lack of schema descriptions and adds meaningful context beyond what the bare schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Get tide information for a specific location and date.' It uses a specific verb ('Get') and resource ('tide information'), and specifies the scope ('for a specific location and date'). However, with no sibling tools provided, there's no opportunity to differentiate from alternatives, preventing a perfect score of 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or constraints. It simply states what the tool does without any context about appropriate usage scenarios. With no siblings listed, this omission is less critical but still represents a gap in guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as retrieving tide information for a specific location and date, making it distinct by default.
The single tool follows a clear verb_noun pattern (get_tides), which is consistent and predictable. Since there are no other tools to compare against, the naming convention is perfectly uniform.
A single tool is too few for a server named 'Surf MCP Server', which implies a broader scope related to surfing or ocean conditions. This minimal toolset feels incomplete and under-scoped for the apparent domain.
The tool surface is severely incomplete for a surfing-related server. While get_tides covers tide information, there are obvious gaps such as wave forecasts, weather data, or surf spot details, which are essential for the domain and will likely cause agent failures.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Find NOAA tide stations and NDBC buoys, fetch tide predictions, currents, and live conditions.
NOAA Tides & Currents — observations, predictions, datums, station metadata
NOAA tides and currents: water levels, tide predictions, currents, met data, flooding, sun and moon
Tides MCP — NOAA Tides and Currents data
Related MCP Servers
- AlicenseDqualityDmaintenanceProvides access to the Timezone By Location API to retrieve timezone information based on geographic location data.1MIT
- FlicenseNot gradedqualityCmaintenanceProvides Canadian tide predictions from the IWLS API, enabling retrieval of 7-day tide forecasts and station listings for monitoring stations across Canada.
- FlicenseNot gradedqualityBmaintenanceMCP server that provides tide predictions, station lookup, and tidal event alerts for US coastal locations using live NOAA data.
- AlicenseNot gradedqualityFmaintenanceProvides NOAA tide predictions and observed water levels, allowing AI agents to query tide stations and current water level data.5MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ravinahp/surf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server