mcp-datetime 0.1.0__py3-none-any.whl

mcp_datetime/__init__.py

@@ -0,0 +1,9 @@
+from . import server
+
+
+def main():
+    """Main entry point for the package."""
+    return server.main()
+
+
+__all__ = ["main", "server"]

mcp_datetime/__main__.py

@@ -0,0 +1,6 @@
+from .server import main
+
+if __name__ == "__main__":
+    import asyncio
+
+    asyncio.run(main())

mcp_datetime/server.py

@@ -0,0 +1,130 @@
+import asyncio
+import logging
+from collections.abc import Sequence
+from datetime import datetime, timezone
+from typing import Any
+
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+from mcp.types import EmbeddedResource, ImageContent, TextContent, Tool
+
+# Prepare logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("mcp-datetime")
+
+# Prepare server
+server = Server("mcp-datetime")
+
+
+# Datetime formatting function
+def format_datetime(format_type: str) -> str:
+    # Generate a new time object each time, considering timezone
+    current_time = datetime.now(timezone.utc).astimezone()
+    formats = {
+        # Basic date formats
+        "date": "%Y-%m-%d",  # 2024-12-10
+        "date_slash": "%Y/%m/%d",  # 2024/12/10
+        "date_jp": "%Y年%m月%d日",  # 2024年12月10日
+        # Basic datetime formats
+        "datetime": "%Y-%m-%d %H:%M:%S",  # 2024-12-10 00:54:01
+        "datetime_jp": "%Y年%m月%d日 %H時%M分%S秒",  # 2024年12月10日 00時54分01秒
+        "datetime_t": "%Y-%m-%dT%H:%M:%S",  # 2024-12-10T00:54:01
+        # Compact formats for filenames or IDs
+        "compact": "%Y%m%d%H%M%S",  # 20241210005401
+        "compact_date": "%Y%m%d",  # 20241210
+        "compact_time": "%H%M%S",  # 005401
+        # Filename formats
+        "filename_md": "%Y%m%d%H%M%S.md",  # 20241210005401.md
+        "filename_txt": "%Y%m%d%H%M%S.txt",  # 20241210005401.txt
+        "filename_log": "%Y%m%d%H%M%S.log",  # 20241210005401.log
+        # ISO 8601 formats
+        "iso": "%Y-%m-%dT%H:%M:%S%z",  # 2024-12-10T00:54:01+0900
+        "iso_basic": "%Y%m%dT%H%M%S%z",  # 20241210T005401+0900
+        # Log formats
+        "log": "%Y-%m-%d %H:%M:%S.%f",  # 2024-12-10 00:54:01.123456
+        "log_compact": "%Y%m%d_%H%M%S",  # 20241210_005401
+        # Time-only formats
+        "time": "%H:%M:%S",  # 00:54:01
+        "time_jp": "%H時%M分%S秒",  # 00時54分01秒
+    }
+
+    if format_type not in formats:
+        raise ValueError(f"Unknown format type: {format_type}")
+
+    try:
+        return current_time.strftime(formats[format_type])
+    except Exception as e:
+        logger.error("Format error: %s", str(e))
+        raise RuntimeError(f"Error formatting date: {str(e)}") from e
+
+
+# Get list of available tools
+@server.list_tools()
+async def list_tools() -> list[Tool]:
+    return [
+        Tool(
+            name="get_datetime",
+            description="Get current date and time in various formats",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "format": {
+                        "type": "string",
+                        "description": """
+Available formats:
+- date: 2024-12-10
+- date_slash: 2024/12/10
+- date_jp: 2024年12月10日
+- datetime: 2024-12-10 00:54:01
+- datetime_jp: 2024年12月10日 00時54分01秒
+- datetime_t: 2024-12-10T00:54:01
+- compact: 20241210005401
+- compact_date: 20241210
+- compact_time: 005401
+- filename_md: 20241210005401.md
+- filename_txt: 20241210005401.txt
+- filename_log: 20241210005401.log
+- iso: 2024-12-10T00:54:01+0900
+- iso_basic: 20241210T005401+0900
+- log: 2024-12-10 00:54:01.123456
+- log_compact: 20241210_005401
+- time: 00:54:01
+- time_jp: 00時54分01秒
+""",
+                    }
+                },
+                "required": ["format"],
+            },
+        )
+    ]
+
+
+# Tool call handler
+@server.call_tool()
+async def call_tool(
+    name: str, arguments: Any
+) -> Sequence[TextContent | ImageContent | EmbeddedResource]:
+    if name == "get_datetime":
+        try:
+            format_type = arguments.get("format")
+            if not format_type:
+                raise ValueError("Format type is required")
+            formatted_time = format_datetime(format_type)
+            return [TextContent(type="text", text=formatted_time)]
+        except ValueError as e:
+            logger.error("Format error: %s", str(e))
+            raise RuntimeError(str(e)) from e
+    else:
+        raise ValueError(f"Unknown tool: {name}")
+
+
+# Main function
+async def main():
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream, write_stream, server.create_initialization_options()
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_datetime-0.1.0.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.3
+Name: mcp-datetime
+Version: 0.1.0
+Summary: A MCP server for datetime formatting and file name generation.
+Project-URL: Repository, https://github.com/ZeparHyfar/mcp-datetime.git
+Author-email: ZeparHyfar <zeparhyfar@gmail.com>
+License: MIT
+Keywords: claude,datetime,format,mcp,time,timezone
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: mcp>=1.1.1
+Provides-Extra: dev
+Requires-Dist: pylint>=3.0.3; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# mcp-datetime
+
+[![Python Version](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/)
+[![MCP Version](https://img.shields.io/badge/mcp-1.1.1-green.svg)](https://github.com/anaisbetts/mcp)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+English | [日本語](README_ja.md)
+
+A datetime formatting service implemented as an MCP server for the Claude Desktop Application. Supports generation of datetime strings in various formats.
+
+## Features
+
+- ✨ Support for various datetime formats
+- 🇯🇵 Japanese language support
+- 📁 Optimized formats for filename generation
+- 🌏 Accurate timezone handling
+- 🔧 Seamless integration with Claude Desktop App
+
+## MCP Server Components
+
+### Tools
+
+The server implements one tool:
+
+- `get_datetime`: Get current date and time in various formats
+  - Takes "format" as a required string argument
+  - Returns formatted datetime string based on specified format
+  - Supports multiple format types including standard, Japanese, and ISO formats
+
+## Usage with Claude Desktop App
+
+Add the following to your config file:
+
+- Config file location:
+
+  - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+  - Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+
+  ```json
+  {
+    "mcpServers": {
+      "mcp-datetime": {
+        "command": "uvx",
+        "args": ["mcp-datetime"]
+      }
+    }
+  }
+  ```
+
+## About Installation
+
+No installation is required for normal use. You can use this package by simply adding the configuration to your Claude Desktop App config file. The uvx command will automatically download and execute the package as needed.
+
+If you need to install the package directly (e.g., for development or source code inspection), you can use one of these methods:
+
+- Install from PyPI
+
+  ```bash
+  pip install mcp-datetime
+  ```
+
+- Install from GitHub Source
+
+  ```bash
+  git clone https://github.com/ZeparHyfar/mcp-datetime.git
+  cd mcp-datetime
+  pip install -e .
+  ```
+
+- `claude_desktop_config.json` for manual installation
+
+  ```json
+  {
+    "mcpServers": {
+      "mcp-datetime": {
+        "command": "python",
+        "args": ["-m", "mcp_datetime"],
+        "env": {
+          "PYTHON": "/path/to/your/python"
+        }
+      }
+    }
+  }
+  ```
+
+  - Replace "/path/to/your/python" with your actual Python interpreter path.
+
+  - Examples:
+    - MacOS: "/usr/local/bin/python3" or "/Users/username/.pyenv/versions/3.12.0/bin/python3"
+    - Windows: "C:\Python312\python.exe"
+
+## Basic Examples
+
+- Command format
+
+  ```
+  # Standard datetime format
+  call datetime-service.get_datetime {"format": "datetime"}
+  # Result: 2024-12-10 00:54:01
+
+  # Japanese format
+  call datetime-service.get_datetime {"format": "datetime_jp"}
+  # Result: 2024年12月10日 00時54分01秒
+
+  # Filename format
+  call datetime-service.get_datetime {"format": "filename_md"}
+  # Result: 20241210005401.md
+  ```
+
+- Claude Desktop App prompt examples
+
+  - User
+
+    ```
+    Please tell me the current time in date_slash format
+    ```
+
+  - Claude
+
+    ```
+    I'll get the current date in date_slash format.
+
+    The current date is 2024/12/12
+    ```
+
+## Supported Formats
+
+| Format Name  | Example                     | Description              |
+| ------------ | --------------------------- | ------------------------ |
+| date         | 2024-12-10                  | Standard date format     |
+| date_slash   | 2024/12/10                  | Date with slashes       |
+| date_jp      | 2024年12月10日              | Japanese date format    |
+| datetime     | 2024-12-10 00:54:01         | Standard datetime       |
+| datetime_jp  | 2024年12月10日 00時54分01秒 | Japanese datetime       |
+| datetime_t   | 2024-12-10T00:54:01         | DateTime with T separator|
+| compact      | 20241210005401              | Compact format for IDs  |
+| compact_date | 20241210                    | Compact date only       |
+| compact_time | 005401                      | Compact time only       |
+| filename_md  | 20241210005401.md           | Markdown filename       |
+| filename_txt | 20241210005401.txt          | Text filename          |
+| filename_log | 20241210005401.log          | Log filename           |
+| iso          | 2024-12-10T00:54:01+0900    | ISO 8601 format        |
+| iso_basic    | 20241210T005401+0900        | Basic ISO format       |
+| log          | 2024-12-10 00:54:01.123456  | Log format with microseconds|
+| log_compact  | 20241210_005401             | Compact log format     |
+| time         | 00:54:01                    | Time only              |
+| time_jp      | 00時54分01秒                | Japanese time format   |
+
+## Debugging
+
+Since MCP servers run over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
+
+- Using PyPI package
+
+  ```
+  npx @modelcontextprotocol/inspector uvx mcp-datetime
+  ```
+
+- Using downloaded source code from GitHub
+
+  ```
+  git clone https://github.com/ZeparHyfar/mcp-datetime.git
+  npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime
+  ```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

mcp_datetime-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+mcp_datetime/__init__.py,sha256=IdxiQAPybMgY3UTm3GPIOb4WScKUFFf2YuO8K-O5mag,135
+mcp_datetime/__main__.py,sha256=ALA29xcNZOjzwjX6U7xi90BiIRbsx10mAmSvxxWWiZo,97
+mcp_datetime/server.py,sha256=SZfuW7tbHnL32YqjU24Zk0BNhf5qsNXRk_QwtHDJ_qM,4277
+mcp_datetime-0.1.0.dist-info/METADATA,sha256=cmlXYi1kvnHtWQdmZzaDpYIzMdncq9BZe_W6GmUvSKg,5986
+mcp_datetime-0.1.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+mcp_datetime-0.1.0.dist-info/entry_points.txt,sha256=rEPiYXeEl45bG10hEnozSfdJdrZ-J3HTYYPmiQdGXhk,51
+mcp_datetime-0.1.0.dist-info/licenses/LICENSE,sha256=2w9RD7tqFXGd_kFE1kE9QxAZyhTouM-aMJ52Ba8MYO8,1067
+mcp_datetime-0.1.0.dist-info/RECORD,,

mcp_datetime-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.26.3
+Root-Is-Purelib: true
+Tag: py3-none-any

mcp_datetime-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-datetime = mcp_datetime:main

mcp_datetime-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ZeparHyfar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.