使用说明

项目简介

Dice Server 是一个实现了 Model Context Protocol (MCP) 的服务器，专门用于提供掷骰子功能。通过此服务器，LLM 应用可以调用 'roll_dice' 工具来模拟掷骰子，并获取结果。

主要功能点

掷骰子: 支持指定骰子的面数和数量。
结果返回: 返回详细的掷骰结果，包括每次骰子的点数和总和。

安装步骤

确保已安装 Node.js 和 npm。

在命令行中运行以下命令安装 Dice Server：

npm install @makimaki/dice-server

服务器配置

要将 Dice Server 集成到 MCP 客户端（例如 Claude.app），需要在客户端的配置文件中添加以下服务器配置信息。以下是一个示例 'Claude.app' 配置文件的 'mcpServers' 部分，展示了如何配置 Dice Server：

{
  "mcpServers": {
    "dice": {
      "command": "dice-server", // Dice Server 的启动命令，通常是安装后添加到 PATH 环境变量的可执行文件名
      "env": {}                // 环境变量配置，此示例中无需额外配置
    }
  }
}

注意: 'command' 字段的值 'dice-server' 假设 '@makimaki/dice-server' 包安装后，会将 'dice-server' 命令添加到系统的 PATH 环境变量中。实际情况可能需要根据你的环境和安装方式进行调整。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 应用中，你可以通过自然语言指令来调用 'roll_dice' 工具。例如，在 Claude 中，你可以这样指示：

请使用 roll_dice 工具掷两个六面骰子。

或者指定骰子面数和数量：

请使用 roll_dice 工具掷一个20面的骰子。

LLM 应用将解析指令，并调用 Dice Server 的 'roll_dice' 工具，然后返回掷骰结果。

关键词