Sun Info Server

日期Sun信息服务器

JSON-RPC API服务器，返回指定纬度、经度和日期的协调世界时（UTC）日出和日落时间。设计为与模型上下文协议（MCP）兼容的工具服务器。

特性

• 计算任何地点的日出和日落时间
• 检测极夜和极日
• 显示UTC时间
• 符合JSON-RPC 2.0标准
• 易于使用Docker运行

技术栈

• PHP 8.4
• 服务器
• Docker&Docker编写
• JSON-RPC 2.0

API概述

端点

• POST / (http://localhost/)

请求格式（JSON-RPC 2.0）

示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "arguments": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "date": "2025-07-14"
    }
  }
}

支持的方法

• initialize：返回服务器信息和功能
• tools/list：返回可用工具（API功能）的列表
• tools/call：计算并返回日出和日落时间

参数

• latitude：纬度（范围：-90到90）
• longitude：经度（范围：-180到180）
• date：YYYY-MM-DD格式的日期（默认为当前日期）

开发与运行

先决条件

• 码头工人
• Docker Compose

如何跑步

1. 克隆存储库

   git clone 
   cd mcp

1. 从Docker开始

   docker compose up --build

1. 服务器运行后，通过向发送POST请求来使用API http://localhost/