MCP Server Demo1

🚀 MCP 時間サーバーデモ

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

このデモは、現在の時刻を取得するツールを提供し、オプションでタイムゾーンを指定することもできます。

🚀 クイックスタート

この MCP 時間サーバーデモを始める前に、いくつかの前提条件を満たす必要があります。また、インストールと使用方法についても説明します。

前提条件

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

インストール

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

   npm install
   

使用方法

1. プロジェクトのコンパイル

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

npm run build

2. サーバーの起動

npm start

✨ 主な機能

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

📚 ドキュメント

初期構築のヒント

要件

提供された MCP 関連の資料を基に、以下の要件を満たす MCP Server を構築してください。

• 現在の時刻を取得するツールを提供する
• タイムゾーンをパラメータとして受け取る（オプション）
• 明確なコメントと説明を記述する
• 機能をシンプルにし、必須の機能のみを含む
• TypeScript で記述する

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

[参考資料 1] MCP 基礎紹介

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

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

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

[参考資料 3] MCP Server 開発ガイド

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

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

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

💻 使用例

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 を通じて問題や提案を提出してください。