MCP Server - 通用功能服务器

一个基于 Model Context Protocol (MCP) 的通用功能服务器，为 AI 提供扩展能力。

支持 本地模式 (stdio) 和 远程模式 (SSE) 双模式运行。

✨ 功能

🕐 时间工具

工具	描述
get_current_time	获取指定时区的当前时间
get_timestamp	获取当前 Unix 时间戳
format_timestamp	将时间戳转换为可读格式

🚀 快速开始

安装依赖

# 使用 uv 安装依赖
uv sync

本地模式运行

uv run mcp-server

远程模式运行

uv run mcp-server --remote --port 8000

🔌 客户端集成

本地模式配置

适用于 Cursor / Claude Desktop：

{
  "mcpServers": {
    "utility-server": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server", "run", "mcp-server"]
    }
  }
}

远程模式配置

先启动远程服务器，然后使用 mcp-remote 适配器连接：

{
  "mcpServers": {
    "utility-server": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://your-server:8000/sse"]
    }
  }
}

🐳 Docker 部署

使用 Docker Compose（推荐）

# 构建并启动
docker compose up -d

# 查看日志
docker compose logs -f

# 停止
docker compose down

手动 Docker 命令

# 构建镜像
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 拉取

docker pull ghcr.io/love-gwen2025/mcp-server:main
docker run -d -p 8000:8000 ghcr.io/love-gwen2025/mcp-server:main

🧪 开发测试

使用 MCP Inspector 进行交互式测试：

uv run mcp dev src/mcp_server/server.py

📖 架构说明

┌─────────────────────────────────────────────────────────────┐
│  运行模式                                                    │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  本地模式 (--remote 未设置)                                  │
│  ├── 使用 stdio 传输                                         │
│  └── AI 客户端直接启动服务器进程                              │
│                                                              │
│  远程模式 (--remote)                                         │
│  ├── 使用 SSE 传输                                           │
│  ├── 监听 HTTP 端口                                          │
│  └── AI 客户端通过网络连接                                   │
│                                                              │
└─────────────────────────────────────────────────────────────┘

📄 许可证

MIT