日時MCPサーバー
簡単なメモ管理とともに日時機能も提供する MCP (Model Completions Protocol) サーバー。
概要
このサーバーは MCP プロトコルを実装し、次のようなさまざまな日時関連のツールとリソースを提供します。
さまざまな形式での現在の日付と時刻
日付フォーマットユーティリティ
イベントスケジュールプロンプト
シンプルなメモ管理機能
このサーバーは、任意の MCP クライアントで使用でき、日付と時刻の情報にアクセスしたり、簡単なメモを管理したりできます。
Related MCP server: mcp-discord-chat MCP server
特徴
リソース
サーバーは次のリソースを提供します。
datetime://current- 現在の日付と時刻datetime://today- ISO形式での今日の日付datetime://time- 24時間形式の現在の時刻note://internal/{name}- ユーザーが作成したメモ
ツール
サーバーは次のツールを提供します。
add-note- 名前と内容を指定して新しいメモを追加するget-current-time- さまざまな形式（ISO、読み取り可能、Unix タイムスタンプ、RFC3339）で現在の時刻を取得します。format-date- 指定されたフォーマットパターンに従って日付文字列をフォーマットします
プロンプト
サーバーは次のプロンプトを提供します。
summarize-notes- すべてのメモの要約を作成しますschedule-event- 特定の時間にイベントをスケジュールするのに役立ちます
インストール
リポジトリをクローンします。
git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server仮想環境を作成します。
uv venv
source .venv/bin/activate依存関係をインストールします。
uv sync使用法
サーバーの実行
サーバーを実行するには:
uv run python -m datetime_mcp_server.serverサーバーが起動し、stdin/stdout で MCP プロトコル メッセージをリッスンします。
サーバーへの接続
任意のMCPクライアントを使用してサーバーに接続できます。例えば、MCP CLIを使用する場合：
uv run mcp connect datetime-mcp-server発達
開発依存関係のインストール
# Install all dependencies including development dependencies
uv sync --devテストの実行
テストを実行するには:
uv run pytest tests/ユニットテスト
ユニット テストでは、個々のサーバー機能が正しく動作することを確認します。
uv run pytest tests/acceptance/test_server.py統合テスト
統合テストでは、サーバーが MCP プロトコルを正しく実装していることを確認します。
uv run pytest tests/acceptance/test_server_integration.py依存関係管理
# Add a production dependency
uv add package_name
# Add a development dependency
uv add --dev package_name
# Sync dependencies from lockfile
uv sync --frozen
# List outdated packages
uv outdated例
MCP CLI でサーバーを使用する
利用可能なリソースを一覧表示します。
uv run mcp resources list日時リソースを読み取ります。
uv run mcp resources read datetime://currentメモを追加:
uv run mcp tools call add-note --arguments '{"name": "meeting", "content": "Team meeting at 3pm"}'現在の時刻を ISO 形式で取得します。
uv run mcp tools call get-current-time --arguments '{"format": "iso"}'日付のフォーマット:
uv run mcp tools call format-date --arguments '{"date": "2023-10-15", "format": "%B %d, %Y"}'Makefileタスク
このプロジェクトには、開発を効率化するための Makefile タスクがいくつか含まれています。
# Sync all dependencies with frozen lockfile
make uv-sync-all
# Sync only development dependencies
make uv-sync-dev
# Run tests
make test建築と出版
配布用のパッケージを準備するには:
依存関係を同期し、ロックファイルを更新します。
uv syncパッケージディストリビューションをビルドします。
uv buildこれにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。
PyPI に公開:
uv publish注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。
トークン:
--tokenまたはUV_PUBLISH_TOKENまたはユーザー名/パスワード:
--username/UV_PUBLISH_USERNAMEおよび--password/UV_PUBLISH_PASSWORD
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。
次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。
npx @modelcontextprotocol/inspector uv --directory /Users/malcolm/dev/bossjones/datetime-mcp-server run datetime-mcp-server起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
ライセンス
マサチューセッツ工科大学
貢献
リポジトリをフォークする
機能ブランチを作成する
変更を加える
uv run pytestでテストを実行します。プルリクエストを送信する