Mix Server

Mix Server

MCP（Model Control Protocol）を通じてローカル時刻機能を提供する、Python ベースのサーバーです。

機能

• さまざまな形式で現在のローカル時刻を取得します
• ファイルや URL を既定のウェブブラウザーで開きます
• シンプルで軽量な実装です
• 簡単に統合できるよう、FastMCP を使用して構築されています
• 高速で信頼性の高い依存関係管理のために uv を使用します

前提条件

• Python 3.x
• uv パッケージマネージャー（ビルドと環境管理に推奨）
• Cursor IDE（開発用）

プロジェクト構成

プロジェクトは、以下の主要なファイルで構成されています。

• 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 と統合するには、~/.cursor/mcp.json にコピーしてください
  • 時刻サービスと順次思考サービスのサーバー設定を定義します

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd mix-server

2. uv を使用して仮想環境を作成し、有効化します：

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

3. uv を使用して依存関係をインストールします：

uv pip install .

4. Cursor の設定を行います：

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

開発

このプロジェクトでは、Python 関連のすべての操作に uv を使用します。

• 環境管理：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」）
  • ファイルの場合：ローカルのファイルパス（相対パスまたは絶対パス）を使用します
  • 操作の結果を示すメッセージを返します

サーバーを起動するには：

uv run main.py

設定

サーバーでは、以下の設定を使用します。

• ローカルタイムゾーン：Asia/Shanghai
• 既定の時刻形式：%Y-%m-%d@%H:%M:%S

ライセンス

[ライセンス情報をここに追加してください]

貢献

[貢献ガイドラインをここに追加してください]