Mix MCP Server

🚀 混合服務器

混合服務器是一個基於 Python 的服務器，通過 MCP（模型控制協議）提供本地時間功能。它能獲取當前本地時間的各種格式，還可在默認網絡瀏覽器中打開文件和 URL，實現簡單且輕量級，藉助 FastMCP 可輕鬆集成，使用 uv 能進行快速可靠的依賴管理。

🚀 快速開始

先決條件

• Python 3.x
• uv 包管理器（推薦用於構建和環境管理）
• Cursor IDE（用於開發）

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd mix-server

2. 創建並激活虛擬環境使用 uv：

uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate  # 在 Windows 上

3. 使用 uv 安裝依賴項：

uv pip install .

4. 設置 Cursor 配置：

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

啟動服務器

uv run main.py

✨ 主要特性

• 獲取當前本地時間的各種格式
• 打開文件和 URL 在默認網絡瀏覽器中
• 簡單且輕量級的實現
• 使用 FastMCP 實現輕鬆集成
• 使用 uv 進行快速可靠依賴管理

📦 安裝指南

克隆倉庫

git clone <repository-url>
cd mix-server

創建並激活虛擬環境

uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate  # 在 Windows 上

安裝依賴項

uv pip install .

設置 Cursor 配置

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

💻 使用示例

基礎用法

# 獲取當前本地時間
from main import get_local_current_time
time = get_local_current_time()
print(time)

# 在默認網絡瀏覽器中打開文件或 URL
from main import open_file_or_url_in_browser
open_file_or_url_in_browser("https://www.google.com")

📚 詳細文檔

項目結構

該項目包含以下關鍵文件：

• 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
  • 定義時間和服務順序思考服務的服務器配置

開發

該項目使用 uv 進行所有 Python 相關操作：

• 環境管理：uv venv
• 包安裝：uv pip install .
• 運行服務器：uv run main.py

使用方法

服務器提供以下功能：

• get_local_current_time()：返回當前本地時間，格式為 "YYYY-MM-DD@HH:MM:SS"
• open_file_or_url_in_browser(target)：在默認網絡瀏覽器中打開文件或 URL
  • 支持本地文件和網絡 URL
  • 對於 URL：使用完整 URL 帶協議（例如："https://www.google.com"）
  • 對於文件：使用本地文件路徑（相對或絕對）
  • 返回操作結果的消息

配置

服務器使用以下配置：

• 本地時區：Asia/Shanghai
• 默認時間格式：%Y-%m-%d@%H:%M:%S

📄 許可證

[在此處添加你的許可信息]