# time-map

**Repository Path**: mathildada/time-mcp

## Basic Information

- **Project Name**: time-map
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Time MCP Server

一个使用 fastMCP 构建的简单时间服务器，提供获取当前时间的功能。

## 功能特性

- ⏰ 获取当前时间戳

## 安装依赖



使用 uv 安装依赖（推荐）：


```bash
pip install uv && cd ~/time-mcp && uv sync
```


## 运行方式

### 1. 直接运行（默认配置）

使用 uv：

默认运行在 `localhost:20213`，使用 SSE 传输协议，并记录 INFO 级别日志。

```bash

uv run main.py 
```

### 2. 自定义参数运行

```bash
# 指定端口和传输协议
python main.py --port 8080 --transport sse

# 指定主机和日志级别
python main.py --host 0.0.0.0 --log-level DEBUG

# 使用STDIO模式（用于MCP客户端连接）
python main.py --transport stdio
```

### 3. 使用命令行工具

安装后可以使用命令行工具：

```bash
# 默认配置
time-mcp

# 自定义配置
time-mcp --port 8080 --transport sse --log-level INFO
```

## 命令行参数

| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `--port` | int | 20213 | 服务器端口 |
| `--transport` | str | sse | 传输协议 (sse/stdio/streamable-http) |
| `--host` | str | localhost | 服务器主机 |
| `--log-level` | str | INFO | 日志级别 (DEBUG/INFO/WARNING/ERROR) |

## MCP 工具

本服务器提供以下 MCP 工具：

### get_current_time
获取当前时间的格式化字符串。

**参数：** 无  
**返回值：** `str` - 格式：`当前时间：YYYY-MM-DD HH:MM:SS`

**示例：**
```
当前时间：2025-09-10 10:30:15
```


## 开发

### 本地开发
```bash
# 克隆项目
git clone <your-repo>
cd time_mcp && uv sync
uv run main.py

finish