日出日落时间计算服务

一个基于JSON-RPC 2.0的API服务器,用于计算指定经纬度和日期的日出日落时间(UTC格式),支持极昼极夜检测,可通过Docker快速部署。

  • by noir4y
  • PHP
  • 本地部署
  • 更新于
在 GitHub 查看 noir4y/mcp-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 <repository-url>
    cd mcp
    
  2. 从Docker开始

    docker compose up --build
    
  3. 服务器运行后,通过向发送POST请求来使用API http://localhost/