MCP 时间服务器示例 (MCP Time Server Demo)

MCP 時刻サーバーの例（MCP Time Server Demo）

これは、TypeScript と @modelcontextprotocol/sdk を使用して構築された、モデルコンテキストプロトコル（MCP）に基づくシンプルなサーバーの例です。

現在時刻を取得するツールを提供し、必要に応じてタイムゾーンを指定できます。

初期構築プロンプト（Initial Build Prompt）

要件

提供された MCP 関連資料に基づいて、次の要件を満たす MCP サーバーを構築してください。

• 現在時刻を取得するツールを提供する
• タイムゾーンをパラメーターとして受け取る（任意）
• 分かりやすいコメントと説明を記述する
• 機能を簡潔にし、主要な機能のみを含める
• TypeScript を使用して記述する

以下の 4 つの資料を参考にしてください。

[参考資料 1] MCP の基本紹介

• https://modelcontextprotocol.io/introduction の内容を貼り付けてください。

[参考資料 2] MCP のコアアーキテクチャ

• https://modelcontextprotocol.io/docs/concepts/architecture の内容を貼り付けてください。

[参考資料 3] MCP サーバー開発ガイド

• https://modelcontextprotocol.io/quickstart/server の内容を貼り付けてください。

[参考資料 4] MCP TypeScript SDK ドキュメント

• https://github.com/modelcontextprotocol/typescript-sdk/blob/main/README.md の内容を貼り付けてください。

機能の特徴

• getCurrentTime ツール：現在時刻を取得します。
  • 任意の timezone パラメーターに対応しています（America/New_York、Asia/Shanghai などの IANA タイムゾーン識別子）。
  • タイムゾーンが指定されていない場合、または無効な場合は、サーバーのローカル時刻を返します。
• MCP 互換：Claude Desktop や MCP Inspector など、MCP に対応する任意のクライアントと統合できます。
• Stdio ベース：標準入出力を使用して通信するため、簡単に統合できます。

前提条件

• Node.js（LTS バージョンを推奨）
• npm（通常は Node.js と一緒にインストールされます）

インストール

1. このリポジトリをクローンするか、ダウンロードします。
2. プロジェクトのルートディレクトリでターミナルを開き、次のコマンドを実行して依存関係をインストールします。

   npm install
   

使用方法

1. プロジェクトをコンパイルする

このプロジェクトは TypeScript で記述されているため、まず JavaScript にコンパイルする必要があります。

npm run build

2. サーバーを実行する

npm start

MCP Inspector を使ったテスト（Testing with MCP Inspector）

1. MCP Inspector をダウンロードしてインストールします。
2. MCP Inspector を起動します。
3. MCP Inspector で新しい MCP セッションを作成します。
4. MCP Inspector で Tools -> Import Tool を選択し、tools/getCurrentTime.ts を選択します。
5. Import ボタンをクリックし、Tools リストから getCurrentTime ツールを見つけます。
6. getCurrentTime ツールをクリックし、Run ボタンをクリックします。
7. 出力結果を確認します。

コントリビューション

コントリビューションを歓迎します！問題や提案は、issues または pull requests でお知らせください。