Time MCP Server

🚀 Time MCP Server

The Model Context Protocol (MCP) server provides tools for retrieving current time information and searching for books in the National Diet Library.

🚀 Quick Start

The Time MCP Server offers tools to get the current time and search for books in the National Diet Library. It supports multiple time formats and can display time in specified time - zones.

✨ Features

• Retrieve the current time in multiple formats (ISO, localized, UNIX timestamp).
• Display time in a specified time zone.
• Search for books in the National Diet Library.

📦 Installation

# Clone the repository
git clone <repository-url>
cd example-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Basic Usage

Run the Server

npm start

This server communicates using standard input and output and is compatible with MCP clients (e.g., Claude).

MCP Configuration

To use this server in an MCP client, add the following to the MCP configuration file:

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

Available Tools

get_current_time

Returns the current time according to the specified format and time zone.

Parameters:

• format (optional): Time format - one of "iso", "locale", "unix", default is "locale".
• timezone (optional): Time zone string (e.g., "Asia/Tokyo", "America/New_York"), default is the system time zone.

Example:

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

Response Example:

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

search_ndl_books

Searches for books in the National Diet Library.

Parameters:

• query (required): Search query (e.g., book title, author, etc.).
• maxResults (optional): Maximum number of returned results, default is 10.

Example:

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

Response Example:

<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>
  <!-- Other entries -->
</feed>

Advanced Usage

Development

# Run in hot - reload development mode
npm run dev

📄 License

ISC