{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yyqcd94zd4bd","handle":"bouse-mcp-time","url":"https://wellknown.network/agents/bouse-mcp-time","links":{"self":"https://wellknown.network/agents/bouse-mcp-time/record.json","html":"https://wellknown.network/agents/bouse-mcp-time","markdown":"https://wellknown.network/agents/bouse-mcp-time/record.md","api":"https://wellknown.network/api/v1/agents/bouse-mcp-time","status":"https://wellknown.network/api/v1/agents/bouse-mcp-time/status","claim":"https://wellknown.network/agents/bouse-mcp-time/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bouse-mcp-time/claim.json","badge":"https://wellknown.network/agents/bouse-mcp-time/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bouse-mcp-time","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bouse-mcp-time","summary":"An MCP service providing time information and time calculations","description":"# Bouse MCP Time Service\n\n一个基于MCP（Model Context Protocol）的时间服务，为AI助手和LLM应用提供强大的时间处理功能。\n\n## 🚀 功能特性\n\n- **获取当前时间** - 支持本地时间和指定时区的时间获取\n- **时区转换** - 在不同时区之间转换时间\n- **时间格式化** - 自定义时间格式输出\n- **时间计算** - 添加天数、小时、分钟到指定时间\n- **时间差计算** - 计算两个时间点之间的差值\n- **时区查询** - 查询特定国家的所有时区信息\n\n## 📦 安装\n\n### 使用 pip 安装\n\n```bash\npip install bouse-mcp-time\n```\n\n### 从源码安装\n\n```bash\ngit clone https://github.com/your-username/bouse-mcp-time.git\ncd bouse-mcp-time\npip install -e .\n```\n\n## 🔧 使用方法\n\n### 作为MCP服务运行\n\n#### 1. STDIO 模式（默认）\n\n```bash\nbouse-mcp-time\n```\n\n#### 2. HTTP SSE 模式\n\n```bash\nbouse-mcp-time --transport sse --host 0.0.0.0 --port 9000\n```\n\n#### 3. HTTP Streamable 模式\n\n```bash\nbouse-mcp-time --transport streamable-http --host 127.0.0.1 --port 9000\n```\n\n### 命令行参数\n\n| 参数 | 说明 | 默认值 |\n|------|------|--------|\n| `--transport` | 传输模式：stdio, sse, streamable-http | stdio |\n| `--host` | 主机地址 | 127.0.0.1 |\n| `--port` | 端口号 | 9000 |\n| `--path` | HTTP路径 | /sse (sse模式) /mcp (streamable-http模式) |\n\n## 🛠️ 可用工具\n\n### 1. 获取本地时间\n```python\nget_local_time() -> str\n```\n返回当前本地时间，格式：`YYYY-MM-DD HH:MM:SS`\n\n### 2. 获取指定时区时间\n```python\nget_current_time(timezone_name: str = \"Asia/Shanghai\") -> str\n```\n返回指定时区的当前时间，默认时区为亚洲/上海\n\n### 3. 时区转换\n```python\nconvert_timezone(time_str: str, from_tz: str, to_tz: str) -> str\n```\n将时间从一个时区转换到另一个时区\n\n**参数：**\n- `time_str`: 时间字符串，格式：`YYYY-MM-DD HH:MM:SS`\n- `from_tz`: 源时区名称\n- `to_tz`: 目标时区名称\n\n### 4. 时间格式化\n```python\nformat_time(time_str: str, format_str: str = \"%Y-%m-%d %H:%M:%S\") -> str\n```\n将时间字符串格式化为指定格式\n\n### 5. 时间加法\n```python\nadd_time(time_str: str, days: int = 0, hours: int = 0, minutes: int = 0) -> str\n```\n在指定时间基础上添加天数、小时、分钟\n\n### 6. 时间差计算\n```python\nget_time_difference(time1: str, time2: str) -> str\n```\n计算两个时间点之间的差值\n\n### 7. 查询国家时区\n```python\nlist_country_timezones(country_name: str) -> str\n```\n列出指定国家的所有时区信息\n\n## 📝 使用示例\n\n### 在AI助手中的应用\n\n当AI助手需要处理时间相关任务时，可以调用这些工具：\n\n1. **获取当前时间**\n   - 用户：\"现在几点了？\"\n   - 助手调用 `get_current_time(\"Asia/Shanghai\")`\n\n2. **时区转换**\n   - 用户：\"纽约现在是几点？\"\n   - 助手调用 `get_current_t…","publisher":{"name":"bouse","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"MIT License  Copyright (c) 2024 bouse  Permission is hereby gra…","protocols":["mcp"],"tags":["agent","ai","llm","mcp","time","timezone"],"pricing":null,"endpoints":[{"url":"pypi:bouse-mcp-time","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bouse-mcp-time","registry":"pypi","observedAt":"2026-09-09T10:32:09.194Z","publishedAt":"2025-06-20T03:21:00.225559Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bouse-mcp-time","url":"https://pypi.org/project/bouse-mcp-time/","firstSeenAt":"2026-09-09T10:27:40.754Z","fetchedAt":"2026-09-09T10:27:40.754Z","normalizedAt":"2026-09-09T10:27:40.754Z"}]},"firstSeenAt":"2026-09-09T10:27:40.754Z","updatedAt":"2026-09-09T10:32:09.197Z"}