Mix Server

by qiaoliang

143 downloads
Not rated
GitHub

About

This is the simplest mcp server in the world to get local current time.

Details

Author
qiaoliang
Downloads
143
Categories
Other

- Get current local time in various formats (single format documented)
- Open files and URLs in the default web browser
- Simple and lightweight implementation using FastMCP
- Uses uv for fast and reliable dependency management
- Designed for easy integration with Cursor IDE
- Python 3.12+ with minimal dependencies (only mcp[cli])

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mix Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the server using uv, set up the provided Cursor configuration example, then start the server with uv run main.py. Once running, you can call get_local_current_time() to return the current time in YYYY-MM-DD@HH:MM:SS format (Asia/Shanghai timezone) or open_file_or_url_in_browser(target) to open a local file or web URL in your default browser.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mix server": {
            "mix-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "mix-mcp-server": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

Mix Server

A Python-based server that provides local time functionality through MCP (Model Control Protocol).

Features

- Get current local time in various formats
- Open files and URLs in the default web browser
- Simple and lightweight implementation
- Built with FastMCP for easy integration
- Uses uv for fast and reliable dependency management

Prerequisites

- Python 3.x
- uv package manager (recommended for build and environment management)
- Cursor IDE (for development)

Project Structure

The project consists of the following key files:

- main.py: The main server implementation with the time functionality
- server.py: Server configuration and setup
- pyproject.toml: Project configuration and dependencies
- Defines project metadata (name, version, description)
- Specifies Python version requirement (>=3.12)
- Lists project dependencies (mcp[cli]>=1.6.0)
- .python-version: Specifies the Python version for the project
- .gitignore: Git ignore rules for the project
- mcp.json.example: Example configuration file for Cursor IDE
- Contains MCP server settings for local development
- Should be copied to ~/.cursor/mcp.json for Cursor integration
- Defines server configurations for time and sequential thinking services

Installation

1. Clone the repository:

git clone <repository-url>
cd mix-server

2. Create and activate virtual environment using uv:
```bash
uv venv
source .venv/bin/activate # On Unix/macOS

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.