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

📚 ドキュメント

プロジェクト構造

このプロジェクトには以下の重要なファイルが含まれています。

• 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 にコピーする必要があります。
  • 時間とサービス順序の思考サービスのサーバ設定を定義します。

開発

このプロジェクトでは、すべての 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

📄 ライセンス

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

貢献ガイド

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