# MCP Server - 通用功能服务器
一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 的通用功能服务器，为 AI 提供扩展能力。
支持 **本地模式 (stdio)** 和 **远程模式 (SSE)** 双模式运行。
## ✨ 功能
### 🕐 时间工具
| 工具 | 描述 |
|------|------|
| `get_current_time` | 获取指定时区的当前时间 |
| `get_timestamp` | 获取当前 Unix 时间戳 |
| `format_timestamp` | 将时间戳转换为可读格式 |
## 🚀 快速开始
### 安装依赖
```bash
# 使用 uv 安装依赖
uv sync
```
### 本地模式运行
```bash
uv run mcp-server
```
### 远程模式运行
```bash
uv run mcp-server --remote --port 8000
```
## 🔌 客户端集成
### 本地模式配置
适用于 Cursor / Claude Desktop：
```json
{
"mcpServers": {
"utility-server": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-server", "run", "mcp-server"]
}
}
}
```
### 远程模式配置
先启动远程服务器，然后使用 `mcp-remote` 适配器连接：
```json
{
"mcpServers": {
"utility-server": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://your-server:8000/sse"]
}
}
}
```
## 🐳 Docker 部署
### 使用 Docker Compose（推荐）
```bash
# 构建并启动
docker compose up -d
# 查看日志
docker compose logs -f
# 停止
docker compose down
```
### 手动 Docker 命令
```bash
# 构建镜像
docker build -t mcp-server .
# 运行容器
docker run -d -p 8000:8000 --name mcp-server mcp-server
# 自定义端口
docker run -d -p 9000:9000 -e PORT=9000 --name mcp-server mcp-server
```
### 从 GitHub Container Registry 拉取
```bash
docker pull ghcr.io/love-gwen2025/mcp-server:main
docker run -d -p 8000:8000 ghcr.io/love-gwen2025/mcp-server:main
```
## 🧪 开发测试
使用 MCP Inspector 进行交互式测试：
```bash
uv run mcp dev src/mcp_server/server.py
```
## 📖 架构说明
```
┌─────────────────────────────────────────────────────────────┐
│ 运行模式 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 本地模式 (--remote 未设置) │
│ ├── 使用 stdio 传输 │
│ └── AI 客户端直接启动服务器进程 │
│ │
│ 远程模式 (--remote) │
│ ├── 使用 SSE 传输 │
│ ├── 监听 HTTP 端口 │
│ └── AI 客户端通过网络连接 │
│ │
└─────────────────────────────────────────────────────────────┘
```
## 📄 许可证
MIT
