MCP Time Precision

MCP时间精度服务器

🕐 高精度时间MCP（模型上下文协议）服务器，为多实例Claude协调提供微秒级的精确时间戳。

特性

• 微秒级精度：时间戳精确到小数点后6位（YYYY-MM-DDTHH:MM:SS.ffffff）
• 纪元微秒：用于精确排序的Unix纪元时间（微秒）
• 实例标识：多Claude部署的唯一实例ID
• 碰撞检测：内置支持检测同时进行的操作
• 时区支持：完全支持IANA时区数据库
• MAGI集成：三个智者设置的预配置实例名称

为什么是微秒级精度？

当运行共享公共内存（Ref）知识图的多个Claude Desktop实例（例如，在Melchior、Balthasar和Caspar机器上）时：

• 第二精度：3个以上实例的高碰撞概率
• 毫秒精度：每秒1/1000碰撞概率
• 微秒级精度：每秒碰撞概率1/1000000

安装

通过pip

pip install mcp-time-precision

通过紫外线（推荐）

uvx mcp-time-precision

来源

git clone https://github.com/SamuraiBuddha/mcp-time-precision.git
cd mcp-time-precision
pip install -e .

配置

克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "time-precision": {
      "command": "python",
      "args": ["-m", "mcp_time_precision", "--instance-id", "Melchior-001"]
    }
  }
}

多实例设置（MAGI）

对于三个智者配置：

Melchior（CAD/3D机器）：

{
  "mcpServers": {
    "time-precision": {
      "command": "python",
      "args": ["-m", "mcp_time_precision", "--instance-id", "Melchior-001"]
    }
  }
}

巴尔塔萨（AI/LLM机器）：

{
  "mcpServers": {
    "time-precision": {
      "command": "python",
      "args": ["-m", "mcp_time_precision", "--instance-id", "Balthasar-001"]
    }
  }
}

Caspar（代码/数据机）：

{
  "mcpServers": {
    "time-precision": {
      "command": "python",
      "args": ["-m", "mcp_time_precision", "--instance-id", "Caspar-001"]
    }
  }
}

可用工具

get_precise_time

以微秒精度获取ISO格式的当前时间。

参数：

• timezone （可选）：IANA时区名称（默认：系统时区）

退货：

{
  "timestamp": "2025-06-16T11:30:45.123456",
  "timezone": "America/New_York",
  "instance_id": "Melchior-001"
}

get_epoch_micros

获取当前Unix纪元时间（微秒）。

退货：

{
  "epoch_micros": 1718553045123456,
  "instance_id": "Melchior-001"
}

get_instance_info

获取有关此MCP实例的信息。

退货：

{
  "instance_id": "Melchior-001",
  "start_time": "2025-06-16T11:00:00.000000",
  "uptime_seconds": 1845.123456,
  "system_info": {
    "hostname": "melchior-workstation",
    "platform": "Windows-11"
  }
}

convert_time_precision

在不同时间精度之间转换。

参数：

• time （必填）：时间字符串或纪元值
• input_format：“iso”、“epoch_seconds”、“划时代毫秒”、“纪元微米”
• output_format：“iso”、“epoch_seconds”、“划时代毫秒”、“纪元微米”
• timezone （可选）：用于ISO格式转换

使用示例

内存面包屑模式

# Get microsecond timestamp for breadcrumb
result = await mcp.call_tool("get_precise_time")
timestamp = result["timestamp"]
instance = result["instance_id"]

# Create breadcrumb: [2025-06-16T11:30:45.123456][Melchior-001][OPERATION][STATUS]
breadcrumb = f"[{timestamp}][{instance}][DOCKER_START][SUCCESS][Started n8n container]"

碰撞检测

# Get epoch microseconds for precise ordering
result = await mcp.call_tool("get_epoch_micros")
epoch_micros = result["epoch_micros"]

# Use for distributed consensus or operation ordering
operation_id = f"{epoch_micros}-{result['instance_id']}"

发展

运行测试

pytest tests/

调试模式

python -m mcp_time_precision --debug --instance-id "Test-001"

MCP检查员

npx @modelcontextprotocol/inspector python -m mcp_time_precision

建筑

• 基于MCP SDK构建，支持标准化协议
• 使用Python time.time() 微秒级精度
• 并发访问的线程安全实现
• 可靠性依赖性最小

贡献

欢迎投稿！特别感兴趣的是：

• 高频通话的性能优化
• 其他时间操纵工具
• 与分布式系统集成
• 替代精度选项（纳秒？）

许可证

MIT许可证-请参阅许可证文件

致谢

• 灵感来自CORTEX中对精确多实例协调的需求
• 以Evangelion的MAGI超级计算机命名
• 为BIM/AI集成的未来而构建

______________________________________________________________________

*“时间是一种幻觉。微秒时间，稍微少一点。”* -向道格拉斯·亚当斯道歉