example-mcp-server

Time MCP Server

Model Context Protocol (MCP) サーバーで、現在の時刻情報と国立国会図書館の本を検索するためのツールを提供します。

機能

• 様々なフォーマット（ISO、ロケール、UNIXタイムスタンプ）で現在の時刻を取得
• 指定したタイムゾーンでの時刻表示
• 国立国会図書館の本を検索

インストール

# リポジトリをクローン
git clone <repository-url>
cd example-mcp-server

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

使用方法

サーバーの実行

npm start

このサーバーは通信にstdioを使用するため、MCPクライアントと互換性があります。

MCP設定

このサーバーをMCPクライアント（Claudeなど）で使用するには、MCP設定ファイルに追加してください：

{
  "mcpServers": {
    "time": {
      "command": "node",
      "args": ["/path/to/example-mcp-server/dist/index.js"]
    }
  }
}

利用可能なツール

get_current_time

指定されたフォーマットとタイムゾーンで現在の時刻を返します。

パラメータ：

• format (省略可能): 時刻フォーマット - "iso"、"locale"、"unix"のいずれか。デフォルトは "locale"。
• timezone (省略可能): タイムゾーン文字列（例："Asia/Tokyo"、"America/New_York"）。デフォルトはシステムのタイムゾーン。

使用例：

{
  "format": "iso",
  "timezone": "Asia/Tokyo"
}

レスポンス例：

{
  "current_time": "2025-04-11T09:51:39.000Z",
  "format": "iso",
  "timezone": "Asia/Tokyo"
}

search_ndl_books

国立国会図書館の本を検索します。

パラメータ：

• query (必須): 検索クエリ（例：書籍名、著者名など）。
• maxResults (省略可能): 取得する最大件数。デフォルトは 10。

使用例：

{
  "query": "夏目漱石",
  "maxResults": 5
}

レスポンス例：

<feed xmlns="http://www.w3.org/2005/Atom">
  <title>NDL Search Results</title>
  <entry>
    <title>吾輩は猫である</title>
    <author>夏目漱石</author>
    <link href="https://ndl.go.jp/..." />
  </entry>
  <!-- 他のエントリ -->
</feed>

開発

# ホットリロードでの開発モードでの実行
npm run dev

ライセンス

ISC