Tides JSON-RPC 访问

使用本指南直接调用已部署的 API：

• 基础 URL：https://hamandmore.net/api/harmonics/mcp
• 请求方法：POST
• Content-Type：application/json
• 协议：JSON-RPC 2.0 请求信封

认证

支持以下任一认证方式：

• 匿名访问：不提供 Authorization 请求头（受限于免费层级的速率限制）
• 密钥访问：添加 Authorization: Bearer 或 Authorization: Basic
• 如需更高使用配额？请发送邮件至 hamandmore@gmail.com 申请认证。

重要说明：

• 此处的 Basic 仅为不透明的令牌前缀，并非 RFC 定义的 Base64 编码认证方式。
• 令牌本身无需满足有效的 Base64 编码格式。

JSON-RPC 信封

所有请求必须包含以下结构：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

• id：任意客户端用于关联请求与响应的标识值
• method：取值为 initialize、tools/list 或 tools/call 之一
• params：对象类型（具体字段要求取决于所选 method）

快速入门命令

初始化：

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

列出可用工具：

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

列出可用工具（密钥访问层级）：

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  -H 'authorization: Bearer YOUR_TOKEN' 
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/list","params":{}}'

工具调用模式

所有工具调用均采用如下结构：

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "TOOL_NAME",
    "arguments": {}
  }
}

cURL 示例

1) 当前时间（tides_time）

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":10,"method":"tools/call","params":{"name":"tides_time","arguments":{}}}'

2) 单点潮汐值（tides_single）

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":11,"method":"tools/call","params":{"name":"tides_single","arguments":{"latitude":40.7128,"longitude":-74.0060,"time":"2026-02-10T00:00:00Z"}}}'

3) 潮汐极值（tides_extrema）

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":12,"method":"tools/call","params":{"name":"tides_extrema","arguments":{"latitude":40.7128,"longitude":-74.0060,"start_time":"2026-02-10T00:00:00Z","end_time":"2026-02-11T00:00:00Z"}}}'

4) 气象观测点数据（weather_met）

curl -sS -X POST https://hamandmore.net/api/harmonics/mcp 
  -H 'content-type: application/json' 
  --data '{"jsonrpc":"2.0","id":13,"method":"tools/call","params":{"name":"weather_met","arguments":{"latitude":40.7128,"longitude":-74.0060,"start_time":"2026-02-10T00:00:00Z","variables":["wind/surface/0","tmp/surface/0"]}}}'

响应结构

成功响应中包含以下字段：

• result.content[0].text：结果为 JSON 字符串形式
• result.structuredContent：结果以对象形式返回（推荐使用该字段）

错误响应遵循 JSON-RPC 的 error 格式，常见错误码包括：

• -32602：参数无效
• -32601：方法未找到
• -32603：服务端或工具内部异常