关键词

掷骰子随机数生成实用工具LLM工具互动功能

项目简介

本项目是一个实现了Model Context Protocol (MCP) 的服务器，专注于提供一个实用的掷骰子工具。通过简单的配置，LLM客户端可以利用此服务器轻松获取随机骰子点数，增强对话和应用场景的互动性。

主要功能点

  • 掷骰子工具 (roll_dice): 核心功能，允许LLM客户端请求模拟掷骰子，并返回点数结果。
  • 可配置骰子参数: 支持自定义骰子的面数 (faces) 和投掷次数 (rolls)，满足不同的随机数需求。
  • 标准MCP协议: 遵循MCP协议规范，易于集成到任何支持MCP协议的LLM客户端。
  • 即装即用: 通过 'npx' 命令即可快速启动，无需复杂的安装和配置过程。

安装步骤

由于本项目已发布到 npm，无需手动下载或构建，只需确保你的开发环境已安装 Node.js 和 npm。

服务器配置

要将 'mcp-server-diceroll' 服务器集成到支持MCP协议的LLM客户端（例如 Claude Desktop），你需要配置客户端的MCP服务器设置。以下是配置信息，请复制到你的客户端配置文件（通常是 'claude_desktop_config.json'）：

{
  "mcpServers": {
    "dice-roll": {
      "command": "npx",
      "args": ["-y", "mcp-server-diceroll"]
    }
  }
}

配置参数说明：

  • 'dice-roll': 这是你为该服务器配置在客户端中设置的名称，可以自定义，用于在客户端中标识和调用此服务器。
  • 'command': 指定启动 MCP 服务器的命令。'npx' 是 npm 包执行器，可以方便地运行未全局安装的 npm 包。
  • 'args': 传递给 'npx' 命令的参数列表。
    • '-y': 'npx' 的参数，表示自动同意安装 'mcp-server-diceroll' 包及其依赖，无需手动确认。
    • 'mcp-server-diceroll': 要执行的 npm 包名称，即 'mcp-server-diceroll'，它会自动运行包的入口文件 ('index.ts')。

注意： 您无需修改或理解 'command' 和 'args' 的具体含义，只需复制粘贴以上 JSON 配置到您的 MCP 客户端配置文件中，并确保客户端能够正确读取并应用这些配置即可。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后，在你的 MCP 客户端中启用名为 'dice-roll' 的 MCP 服务器连接。客户端会自动根据配置信息启动 'mcp-server-diceroll' 服务器。
  2. 调用掷骰子工具: 在 LLM 客户端中，你可以指示 LLM 使用 'roll_dice' 工具。例如，你可以向 LLM 发送指令，例如 "请掷一下骰子" 或 "roll a dice"。
  3. 参数设置 (可选): 'roll_dice' 工具接受 'faces' 和 'rolls' 参数。如果你需要掷不同面数的骰子或多次投掷，可以在调用工具时指定参数。具体的调用方式取决于你的 LLM 客户端的实现。例如，在某些客户端中，你可能需要使用特定的语法来指示 LLM 调用工具并传递参数，例如：'roll_dice(faces=20, rolls=2)' 来投掷2次20面骰子。

简化使用提示: 对于 Claude Desktop 等 MCP 客户端，通常只需配置好服务器信息并启动，即可在对话中自然地指示 Claude 使用 "roll_dice" 工具，无需关心底层的 MCP 协议细节。客户端会自动处理工具发现和调用过程。

信息

分类

AI与计算

访问项目