🚀 混合服务器
混合服务器是一个基于 Python 的服务器，通过 MCP（模型控制协议）提供本地时间功能。它能获取当前本地时间的各种格式，还可在默认网络浏览器中打开文件和 URL，实现简单且轻量级，借助 FastMCP 可轻松集成，使用 uv 能进行快速可靠的依赖管理。
🚀 快速开始
先决条件
- Python 3.x
- uv 包管理器（推荐用于构建和环境管理）
- Cursor IDE（用于开发）
安装步骤
- 克隆仓库：
git clone
cd mix-server
- 创建并激活虚拟环境使用 uv：
uv venv
source .venv/bin/activate # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate # 在 Windows 上
- 使用 uv 安装依赖项：
uv pip install .
- 设置 Cursor 配置：
cp mcp_config.json.example ~/.cursor/mcp.json
启动服务器
uv run main.py
✨ 主要特性
- 获取当前本地时间的各种格式
- 打开文件和 URL 在默认网络浏览器中
- 简单且轻量级的实现
- 使用 FastMCP 实现轻松集成
- 使用 uv 进行快速可靠依赖管理
📦 安装指南
克隆仓库
git clone
cd mix-server
创建并激活虚拟环境
uv venv
source .venv/bin/activate # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate # 在 Windows 上
安装依赖项
uv pip install .
设置 Cursor 配置
cp mcp_config.json.example ~/.cursor/mcp.json
💻 使用示例
基础用法
# 获取当前本地时间
from main import get_local_current_time
time = get_local_current_time()
print(time)
# 在默认网络浏览器中打开文件或 URL
from main import open_file_or_url_in_browser
open_file_or_url_in_browser("https://www.google.com")
📚 详细文档
项目结构
该项目包含以下关键文件：
main.py：主要服务器实现文件，包含时间功能server.py：服务器配置和设置pyproject.toml：项目配置和依赖- 定义项目元数据（名称、版本、描述）
- 指定 Python 版本要求（>=3.12）
- 列出项目依赖项（mcp[cli]>=1.6.0）
.python-version：指定项目的 Python 版本.gitignore：Git 忽略规则mcp.json.example：用于 Cursor IDE 的示例配置文件- 包含本地开发的 MCP 服务器设置
- 应该复制到
~/.cursor/mcp.json - 定义时间和服务顺序思考服务的服务器配置
开发
该项目使用 uv 进行所有 Python 相关操作：
- 环境管理：
uv venv - 包安装：
uv pip install . - 运行服务器：
uv run main.py
使用方法
服务器提供以下功能：
get_local_current_time()：返回当前本地时间，格式为 "YYYY-MM-DD@HH:MM:SS"open_file_or_url_in_browser(target)：在默认网络浏览器中打开文件或 URL- 支持本地文件和网络 URL
- 对于 URL：使用完整 URL 带协议（例如："https://www.google.com"）
- 对于文件：使用本地文件路径（相对或绝对）
- 返回操作结果的消息
配置
服务器使用以下配置：
- 本地时区：Asia/Shanghai
- 默认时间格式：%Y-%m-%d@%H:%M:%S
📄 许可证
[在此处添加你的许可信息]