Mix Server

Mix Server

一个基于 Python 的服务，通过 MCP（模型上下文协议）提供本地时间功能。

功能

• 以多种格式获取当前本地时间
• 在默认浏览器中打开文件和 URL
• 实现简单、轻量
• 使用 FastMCP 构建，便于集成
• 使用 uv 进行快速可靠的依赖项管理

前置条件

• Python 3.x
• uv 包管理器（推荐用于构建和环境管理）
• Cursor IDE（用于开发）

项目结构

项目包含以下关键文件：

• 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，以便与 Cursor 集成
  • 定义时间服务和顺序思考服务的服务配置

安装

1. 克隆仓库：

git clone <repository-url>
cd mix-server

2. 使用 uv 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

3. 使用 uv 安装依赖项：

uv pip install .

4. 设置 Cursor 配置：

cp mcp_config.json.example ~/.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"）
  • 对于文件：使用本地文件路径（相对路径或绝对路径）
  • 返回一条消息，说明操作结果

启动服务：

uv run main.py

配置

服务使用以下配置：

• 本地时区：Asia/Shanghai
• 默认时间格式：%Y-%m-%d@%H:%M:%S

许可证

[在此处添加许可证信息]

贡献

[在此处添加贡献指南]