Mix Server

By qiaoliang GitHub

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

Overview

What is Mix Server?

Mix Server is a Python-based server that provides local time functionality through the Model Control Protocol (MCP). It is designed to be simple and lightweight, making it easy to integrate into various applications.

How to use Mix Server?

To use Mix Server, clone the repository, set up a virtual environment, install the necessary dependencies, and run the server using the provided commands. The server can then be accessed to get the current local time in various formats.

Key features of Mix Server?

Get current local time in various formats
Simple and lightweight implementation
Built with FastMCP for easy integration
Uses uv for fast and reliable dependency management

Use cases of Mix Server?

Providing local time functionality for applications
Integrating time services into IoT devices
Developing time-sensitive applications that require accurate local time

FAQ from Mix Server?

What programming language is Mix Server built with?

Mix Server is built with Python.

How do I install Mix Server?

You can install Mix Server by cloning the repository and following the installation instructions provided in the documentation.

Can I customize the time format?

Yes! The default time format can be configured in the server settings.

Content

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

Clone the repository:

git clone <repository-url>
cd mix-server

Create and activate virtual environment using uv:

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

Install dependencies using uv:

uv pip install .

Set up Cursor configuration:

cp mcp_config.json.example ~/.cursor/mcp.json

Development

The project uses uv for all Python-related operations:

Environment management: uv venv
Package installation: uv pip install .
Running the server: uv run main.py

Usage

The server provides the following functionality:

get_local_current_time(): Returns the current local time in the format "YYYY-MM-DD@HH:MM:SS"
open_file_or_url_in_browser(target): Opens a file or URL in the default web browser
- Supports both local files and web URLs
- For URLs: Use complete URL with protocol (e.g., "https://www.google.com")
- For files: Use local file path (relative or absolute)
- Returns a message indicating the result of the operation

To start the server:

uv run main.py

Configuration

The server uses the following configuration:

Local timezone: Asia/Shanghai
Default time format: %Y-%m-%d@%H:%M:%S

License

[Add your license information here]

Contributing

[Add contribution guidelines here]

No tools information available.

No content found.