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 
cd mix-server

2. Create and activate virtual environment using uv:

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

3. Install dependencies using uv:

uv pip install .

4. 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]