Files

cnphpbb 648faac289 feat: 添加MCP时间服务器及相关工具

实现一个基于Golang的MCP时间服务器，提供获取当前时间和日期功能
包含客户端示例、安装脚本和详细文档

refactor: 优化磁盘巡检脚本以支持SAS和SSD硬盘

增强磁盘巡检脚本的兼容性，改进SMART信息解析逻辑
添加硬盘类型检测和更全面的错误处理

docs: 更新README和安装说明

添加MCP时间服务器的使用文档和API说明
完善磁盘巡检报告格式和内容

2025-09-12 13:45:08 +08:00

3.6 KiB

Raw Blame History

MCP Time Server

一个使用Golang实现的MCP（Model Context Protocol）服务器，提供获取当前系统时间和SSE（Server-Sent Events）实时时间流功能。

项目概述

这个服务器实现了自定义的MCP协议，允许客户端通过HTTP接口获取当前系统时间，并且支持通过SSE技术订阅实时时间更新流。服务器使用slog库进行日志记录，日志仅输出到控制台。

功能特性

提供获取当前系统时间的MCP工具（get_current_time）
支持自定义时间格式
实现SSE（Server-Sent Events）功能，提供实时时间流订阅（subscribe_time_stream）
使用slog进行结构化日志记录
基于HTTP实现MCP协议
提供健康检查接口
支持优雅关闭

目录结构

mcpTimeServer/
├── main.go      # 服务器主程序
├── go.mod       # Go模块定义
├── install.sh   # 安装脚本
└── README.md    # 项目说明文档

安装与配置

前提条件

Go 1.21或更高版本

安装步骤

克隆项目或进入项目目录
运行安装脚本：
```
chmod +x install.sh
./install.sh
```
安装脚本会检查Go环境、安装依赖并编译项目。

使用方法

启动服务器

./mcp_time_server

服务器启动后，会在8080端口监听HTTP请求。

API说明

MCP协议接口

提交MCP请求

URL: /mcp/v1/submit
方法: POST
Content-Type: application/json

请求体示例:

{
  "data": {"format": "2006-01-02 15:04:05"}, // 可选参数
  "type": "get_current_time",
  "timestamp": 1699999999
}

可用工具

get_current_time
- 参数: format（可选）- 时间格式字符串，使用Go的时间格式语法（如"2006-01-02 15:04:05"）
- 返回结果:
```
{
  "current_time": "格式化的时间字符串",
  "timestamp": 时间戳（Unix时间，秒）
}
```
subscribe_time_stream
- 参数:
  - interval（可选）- 时间更新间隔（秒），默认为1秒
  - format（可选）- 时间格式字符串
- 返回结果:
```
{
  "stream_id": "唯一的流标识符",
  "sse_url": "http://localhost:8080/sse",
  "interval": 更新间隔（秒）
}
```

SSE接口

URL: /sse
方法: GET
Content-Type: text/event-stream

连接后，服务器会以指定的间隔发送时间更新事件。

健康检查接口

URL: /health
方法: GET
返回: 状态码200表示服务器正常运行

测试方法

服务器启动后，可以使用以下方式测试：

健康检查:
```
curl http://localhost:8080/health
```

获取当前时间:

curl -X POST http://localhost:8080/mcp/v1/submit -H 'Content-Type: application/json' -d '{"data":{},"type":"get_current_time","timestamp":'$(date +%s)'}'

使用自定义格式获取当前时间:

curl -X POST http://localhost:8080/mcp/v1/submit -H 'Content-Type: application/json' -d '{"data":{"format":"2006-01-02 15:04:05"},"type":"get_current_time","timestamp":'$(date +%s)'}'

订阅时间流:
```
curl http://localhost:8080/sse
```
或直接在浏览器中访问 http://localhost:8080/sse

依赖说明

github.com/google/uuid v1.6.0：用于生成唯一标识符

注意事项

服务器默认监听在8080端口
日志仅输出到控制台，不会写入文件
SSE连接会在客户端断开或服务器关闭时终止

License

MIT

3.6 KiB Raw Blame History Unescape Escape