MCP Time Server

一个基于 Model Context Protocol (MCP) 的时间服务器，支持通过 StreamableHTTP 传输协议提供当前时间查询服务。

功能特性

• 🕒 支持多时区时间查询
• 🌐 使用 MCP StreamableHTTP 协议
• 🎯 同时支持有状态和无状态模式
• 📦 提供 JSON-RPC 接口
• 🔧 支持多种运行模式（Studio、SSE、StreamableHTTP）

安装

pip install mcp-time-server

快速开始

启动服务器

使用 StreamableHTTP 模式启动服务器（推荐生产环境使用）：

python -m mcp_time_server streamable-http

或者使用命令行脚本：

mcp-time-server streamable-http

支持的运行模式

1. Studio 模式（默认）：使用 stdio 传输，适用于本地进程间通信

   python -m mcp_time_server studio
   

2. SSE 模式：使用 Server-Sent Events 传输

   python -m mcp_time_server sse
   

3. StreamableHTTP 模式：推荐的生产环境传输方式

   python -m mcp_time_server streamable-http
   

API 文档

get_current_time

获取指定时区的当前时间。

参数

• timezone (可选): 时区字符串，例如 "Asia/Shanghai"、"America/New_York"

返回值

格式化的当前时间字符串，格式为：YYYY-MM-DD HH:MM:SS.ffffff TZ

示例请求

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_current_time",
    "arguments": {
      "timezone": "Asia/Shanghai"
    }
  }
}

示例响应

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "2025-12-31 14:35:58.589092 CST"
      }
    ],
    "structuredContent": {
      "result": "2025-12-31 14:35:58.589092 CST"
    },
    "isError": false
  }
}

客户端示例

Python 客户端

import requests
import json

BASE_URL = "http://localhost:8000/mcp"

# 发送 JSON-RPC 请求
def send_json_rpc(method, params):
    request = {
        "jsonrpc": "2.0",
        "id": "1",
        "method": method,
        "params": params
    }
    
    headers = {
        "Content-Type": "application/json",
        "Accept": "application/json"
    }
    
    response = requests.post(BASE_URL, json=request, headers=headers)
    return response.json()

# 获取当前时间
result = send_json_rpc("tools/call", {
    "name": "get_current_time",
    "arguments": {
        "timezone": "Asia/Shanghai"
    }
})

print(result)

配置说明

服务器支持通过配置文件进行自定义设置：

# mcp_server_config.py
MODES = {
    "streamable-http": {
        "transport": "streamable-http",
        "description": "StreamableHttp模式 - 推荐的生产环境传输方式",
        "stateless_http": True,
        "json_response": True,
        "host": "0.0.0.0",
        "port": 8000
    }
}

技术栈

• Python 3.7+
• FastAPI
• Starlette
• MCP Protocol
• pytz

开发

安装开发依赖

pip install -e .

运行测试

python -m pytest

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

关于 MCP

Model Context Protocol (MCP) 是一个用于构建服务器的协议，允许你以安全、标准化的方式向 LLM 应用程序公开数据和功能。

了解更多：Model Context Protocol