关键词

轮盘抽奖在线工具随机选择互动应用LLM工具

项目简介

roulette-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它提供了一个有趣的在线抽奖轮盘功能。这个服务器可以与支持 MCP 协议的 LLM 客户端配合使用，使 LLM 能够通过调用预设的工具来控制和使用轮盘，从而为用户提供互动式的体验，例如在对话中进行随机选择或决策。

主要功能点

  • 轮盘抽奖工具: 核心功能是提供 'spin_roulette' 工具，允许客户端指定轮盘的选项，并随机返回一个结果。
  • 可定制选项: 轮盘的选项可以由客户端在调用工具时动态指定，提供了灵活性和定制性。
  • 简单的文本输出: 工具执行结果以包含动画效果的文本形式返回，方便 LLM 客户端直接展示或整合到对话中。
  • 标准 MCP 服务器: 遵循 MCP 协议，易于与任何兼容的 MCP 客户端集成。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的环境中已安装 Node.js 和 npm (Node 包管理器)。

  2. 安装 roulette-mcp 包: 打开终端，运行以下命令安装 'roulette-mcp' 包：

    npm install roulette-mcp

服务器配置

要将 'roulette-mcp-server' 配置为 MCP 服务器，你需要在 MCP 客户端的配置文件中添加如下服务器配置信息。以下是一个 JSON 格式的配置示例，通常 MCP 客户端会读取这个配置来启动和管理 MCP 服务器：

{
  "mcpServers": {
    "roulette": {
      "command": "npx",
      "args": ["roulette-mcp"],
      "env": {}
    }
  }
}

配置参数说明:

  • '"roulette"': 服务器名称，可以自定义，用于在客户端中标识和引用该服务器。
  • '"command": "npx"': 启动服务器的命令。'npx' 是 npm 包执行器，用于运行本地安装的 npm 包的可执行文件。
  • '"args": ["roulette-mcp"]': 传递给 'npx' 命令的参数。'roulette-mcp' 是 'roulette-mcp' 包提供的可执行文件名，用于启动 MCP 服务器。
  • '"env": {}': 环境变量配置，默认为空，可以根据需要添加环境变量。

请注意: 你需要将以上 JSON 配置添加到你的 MCP 客户端的配置文件中。具体的配置文件位置和格式取决于你使用的 MCP 客户端。

基本使用方法

配置完成后，在 MCP 客户端中，你可以通过调用 'spin_roulette' 工具来使用轮盘功能。

调用 'spin_roulette' 工具:

客户端需要构造一个符合 MCP 协议的 'CallToolRequest' 请求，指定工具名称为 'spin_roulette'，并提供相应的参数。

工具输入参数 (JSON 格式):

{
  "options": ["选项1", "选项2", "选项3", "选项4"]
}
  • 'options': 一个字符串数组，包含了轮盘的所有选项。如果不提供此参数，将使用默认选项 '['大吉', '中吉', '小吉', '吉', '末吉', '凶']'。

工具执行结果:

服务器会随机从 'options' 数组中选择一个选项，并返回包含轮盘动画效果和最终结果的文本内容。客户端会接收到 MCP 协议的 'CallToolResponse' 响应，其中 'content' 字段包含了文本结果。

示例结果 (文本内容):

🎲 ルーレットを回しています...
🎯 選択中...
✨ 結果は... 吉 です！

客户端可以将这段文本展示给用户，或进一步处理。

通过以上步骤，你就可以成功安装、配置和使用 'roulette-mcp-server' 提供的轮盘抽奖工具了。

信息

分类

AI与计算

访问项目