# Time MCP Server

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

## 機能

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

## インストール

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

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

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

## 使用方法

### サーバーの実行

```bash
npm start
```

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

### MCP設定

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

```json
{
  "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"）。デフォルトはシステムのタイムゾーン。

**使用例：**

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

**レスポンス例：**

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

#### search_ndl_books

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

**パラメータ：**

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

**使用例：**

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

**レスポンス例：**

```xml
<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>
```

## 開発

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

## ライセンス

ISC