mcpField
M
Mix Server

Mix Server

Local
github.com/qiaoliangOther0Updated 80w ago
Repository

About Mix Server

Mix Server is a Python-based MCP server built with FastMCP for clients that need local time and browser actions. It returns the current time in a configured timezone and can open local files or URLs in the default browser.

Key features

  1. 01Get the current local time
  2. 02Return time in a specified format
  3. 03Open files or URLs in the default browser
  4. 04Built with FastMCP

Use cases

  1. 01Check the current time in Asia/Shanghai
  2. 02Open a local file in the browser
  3. 03Visit a webpage in the browser

MCP support

It exposes tools to MCP clients for retrieving local time and opening files or URLs in the default browser.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. Create and activate virtual environment using uv:
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Install dependencies using uv:
uv pip install .
  1. 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]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.