Datetime MCP Server

🚀 DateTime MCP サーバー

このサーバーは、日付と時刻、および簡単なメモ管理機能を提供するMCP（モデル完了プロトコル）サーバーです。日付と時刻に関する情報やメモ管理機能をMCPクライアントに提供することができます。

🚀 クイックスタート

このDateTime MCPサーバーを使用することで、日付と時刻に関する情報や簡単なメモ管理機能を利用できます。以下の手順に従って、サーバーをセットアップして使用してください。

✨ 主な機能

リソース

サーバーが提供するリソースは以下の通りです。

• 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 - 特定の時間にイベントをスケジュールするのを支援する

📦 インストール

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

git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server

2. 仮想環境を作成します。

uv venv
source .venv/bin/activate

3. 依存関係をインストールします。

uv sync

💻 使用例

基本的な使用法

サーバーを起動する

サーバーを起動するには、以下のコマンドを実行します。

uv run python -m datetime_mcp_server.server

サーバーが起動し、stdin/stdoutでMCPプロトコルメッセージを待ち受けます。

サーバーに接続する

任意のMCPクライアントを使用してサーバーに接続できます。例えば、MCP CLIを使用する場合は、以下のコマンドを実行します。

uv run mcp connect datetime-mcp-server

📚 ドキュメント

開発

開発用の依存関係をインストールする

# 開発用の依存関係を含むすべての依存関係をインストールする
uv sync --dev

テストを実行する

テストを実行するには、以下のコマンドを実行します。

uv run pytest tests/

単体テスト

単体テストは、サーバーの各機能が正常に動作することを検証します。

uv run pytest tests/acceptance/test_server.py

統合テスト

統合テストは、サーバーの各部分間の相互作用を検証します。

uv run pytest tests/integration/test_integration.py

Makefileタスクの使用

ドキュメントにはMakefileの具体的な内容は記載されていませんが、通常は以下のタスクが含まれます。

• make install - 依存関係をインストールする
• make test - テストを実行する
• make lint - コードの形式を整え、コードスタイルをチェックする
• make build - リリースパッケージをビルドする

📄 ライセンス

MIT

貢献の方法

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. uv run pytest を使用してテストを実行する
5. プルリクエストを送信する