Mix Server

一个基于 Python 的服务器，通过 MCP (模型控制协议) 提供本地时间功能。

特性

• 获取各种格式的当前本地时间
• 在默认 Web 浏览器中打开文件和 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  # 在 Unix/macOS 上
# 或
.venv\Scripts\activate  # 在 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): 在默认 Web 浏览器中打开文件或 URL
  • 支持本地文件和 Web URL
  • 对于 URL：使用完整的 URL，包括协议 (例如，"https://www.google.com")
  • 对于文件：使用本地文件路径（相对或绝对）
  • 返回一条消息，指示操作结果

要启动服务器：

uv run main.py

配置

服务器使用以下配置：

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

许可证

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

贡献

[在此处添加贡献指南]