AI导哈

本地时间服务器

一个基于Python的服务器，通过MCP协议提供本地时间功能和浏览器文件/URL打开功能，适用于需要快速获取本地时间或通过默认浏览器打开资源的开发场景。

  • by qiaoliang
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 qiaoliang/mix-mcp-server

使用说明

混合服务器

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

特性

  • 获取各种格式的当前本地时间
  • 在默认web浏览器中打开文件和URL
  • 简单轻便的实现
  • 内置FastMCP，易于集成
  • 使用uv进行快速可靠的依赖关系管理

先决条件

  • Python 3.x
  • uv包管理器（建议用于构建和环境管理）
  • 游标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
  1. 使用uv创建和激活虚拟环境：
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. 使用uv安装依赖项：
uv pip install .
  1. 设置游标配置：
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：毫米：秒“
  • open_file_or_url_in_browser(target)：在默认web浏览器中打开文件或URL
    • 支持本地文件和web URL
    • 对于URL：使用带有协议的完整URL（例如，“https://www.google.com")
    • 对于文件：使用本地文件路径（相对或绝对）
    • 返回一条指示操作结果的消息

要启动服务器，请执行以下操作：

uv run main.py

配置

服务器使用以下配置：

  • 当地时区：亚洲/上海
  • 默认时间格式：%Y-%m-%d@%H:%m:%S

许可证

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

贡献

[在此处添加贡献指南]

相关 MCP