Slowtime MCP Server 使用说明

项目简介

Slowtime MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器,专注于为大型语言模型 (LLM) 客户端提供时间相关的安全功能。它通过时间间隔管理时间锁加密技术,增强数据安全性,并防止定时攻击。该服务器主要用于需要在特定时间后才能访问或解密数据的应用场景,例如定时公开的秘密信息、限时访问权限等。

主要功能点

  • 时间间隔管理 (Interval Management):
    • 创建、暂停、恢复和查询时间间隔。
    • 可以设置专注时间、任务倒计时等时间管理功能。
  • 时间锁加密 (Timelock Encryption):
    • 使用时间锁技术加密数据,确保数据在预设时间间隔结束后才能解密。
    • 结合分布式随机信标网络 (drand) 保证时间戳的公正性和安全性。
  • 定时攻击防护 (Timing Attack Protection):
    • 通过随机延迟、时间抖动和恒定时间比较等技术,防止通过时间分析进行的攻击。
  • 数据持久化与分析 (TimeVault Analytics):
    • 使用 DuckDB WASM 数据库持久化存储加密数据和操作历史。
    • 提供数据查询和统计分析功能,方便审计和监控。

安装步骤

  1. 下载仓库代码: 从 GitHub 仓库 https://github.com/bmorphism/slowtime-mcp-server 下载或克隆代码到本地。
  2. 安装 Node.js 环境: 确保你的系统已安装 Node.js 和 npm (或 yarn)。
  3. 安装依赖: 在仓库根目录下,打开终端并运行 'npm install' 或 'yarn install' 安装项目依赖。
  4. 构建项目: 运行 'npm run build' 或 'yarn build' 构建项目,生成可执行的 JavaScript 文件。构建后的文件位于 'build' 目录下。

服务器配置

要将 Slowtime MCP Server 集成到 MCP 客户端(例如 Claude Desktop),你需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 客户端的配置示例,你需要将这段 JSON 配置添加到 '~/Library/Application Support/Claude/claude_desktop_config.json' 文件中 (macOS 系统,其他系统路径可能不同):

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

配置参数说明:

  • '"slowtime"': 服务器名称,可以自定义,用于在客户端中标识该服务器。
  • '"command": "node"': 启动服务器的命令。这里使用 Node.js 运行 JavaScript 文件。
  • '"args": ["/path/to/slowtime-mcp-server/build/index.js"]': 命令的参数。你需要将 '/path/to/slowtime-mcp-server' 替换为 Slowtime MCP Server 项目 'build' 目录的实际绝对路径。 例如,如果你的项目放在用户主目录下的 'slowtime-mcp-server' 文件夹中,并且已经执行了构建命令,那么路径可能类似于 '/Users/yourusername/slowtime-mcp-server/build/index.js'。

请注意: '/path/to/slowtime-mcp-server/build/index.js' 必须是构建后 'index.js' 文件的绝对路径。你需要根据你的实际文件位置进行修改。

基本使用方法

配置完成后,你的 MCP 客户端 (如 Claude Desktop) 应该能够连接到 Slowtime MCP Server。你可以通过客户端的功能调用 Slowtime Server 提供的工具 (Tools),例如:

  • 启动时间间隔: 使用 'start_interval' 工具创建新的时间间隔,例如:'start_interval "工作专注" 25' (创建一个名为 "工作专注" 的 25 分钟间隔)。
  • 查询时间间隔状态: 使用 'check_interval <interval_id>' 查询指定 ID 的时间间隔状态。
  • 暂停/恢复时间间隔: 使用 'pause_interval <interval_id>' 和 'resume_interval <interval_id>' 控制时间间隔。
  • 时间锁加密数据: 使用 'encrypt_with_timelock' 工具加密数据,需要提供要加密的数据和关联的时间间隔 ID。
  • 尝试解密数据: 使用 'decrypt_timelock <timelock_id>' 尝试解密指定 ID 的时间锁数据。只有当关联的时间间隔结束后才能成功解密。
  • 查询历史记录和统计信息: 使用 'list_vault_history' 和 'get_vault_stats' 工具查询时间锁数据的历史记录和统计信息。

提示: 具体工具的使用方法和参数可以在客户端的工具列表或帮助文档中查看 (如果客户端提供)。Slowtime MCP Server 提供了详细的工具描述信息,客户端应该能够展示这些信息。

信息

分类

AI与计算