MCP服务器,用于冲浪波和网络的人.

□ 图

□ 视频演示 https://github.com/user-attachments/assets/0a4453e2-66df-4bf5-8366-8538cda366ed

□ 特性

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

□ 先决条件

• Python 3.x (英语).
• 暴风玻璃API密钥

□ 获得暴风雨玻璃 API 密钥

1. 参观风暴玻璃
2. 点击"Try for Free"或"Sign In"创建账户
3. 注册后,你会收到你的API密钥

关于 API 使用限制的说明 :

• 免费:每天10个申请
• 现有付费计划:
• 小:每天500项请求(19欧元/月)
• 中等:每天要求5000项(49欧元/月)
• 大型:每天25 000项请求(129欧元/月)
• 企业:有自定义计划

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

□ 安装

1. 清除储存库:

2. 使用uv安装依赖性:

注:我们使用uv而不是管道,因为该项目使用pyproject.toml进行依赖管理。

□ 配置为 MCP 服务器

Surf MCP Server

MCP server for people who surf waves and the web.

Diagram

Video Demo

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

Features

• Fetch tide information for any location using latitude and longitude
• Support for date-specific tide queries
• Detailed tide data including high/low tides and station information
• Automatic time zone handling (UTC)

Prerequisites

• Python 3.x
• Storm Glass API key

Getting Your Storm Glass API Key

1. Visit Storm Glass
2. Click “Try for Free” or “Sign In” to create an account
3. Once registered, you’ll receive your API key

Note on API Usage Limits:

• Free tier: 10 requests per day
• Paid plans available:
  • Small: 500 requests/day (€19/month)
  • Medium: 5000 requests/day (€49/month)
  • Large: 25,000 requests/day (€129/month)
  • Enterprise: Custom plans available

Choose a plan based on your usage requirements. The free tier is suitable for testing and personal use.

Installation

1. Clone the repository:

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

2. Install dependencies using uv:

uv sync

Note: We use uv instead of pip since the project uses pyproject.toml for dependency management.

Configure as MCP Server

To add this tool as an MCP server, you’ll need to modify your Claude desktop configuration file. This configuration includes your Storm Glass API key, so you won’t need to set it up separately.

The configuration file location depends on your operating system:

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

Add the following configuration to your JSON file:

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

⚠️ IMPORTANT:

1. Replace YOUR_USERNAME with your actual system username
2. Replace your_api_key_here with your actual Storm Glass API key
3. Make sure the directory path matches your local installation

Deployment

Building

To prepare the package:

1. Sync dependencies and update lockfile:

uv sync

2. Build package:

uv build

This will create distributions in the dist/ directory.

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector with this command:

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