关键词

石头剪刀布游戏LLM工具示例服务器Node.js游戏API

使用说明

项目简介

这是一个使用Model Context Protocol (MCP) SDK开发的简单服务器，它实现了一个石头剪刀布游戏工具。LLM客户端可以通过MCP协议调用这个工具与服务器进行互动。

主要功能点

  • 提供石头剪刀布游戏工具: 服务器注册了一个名为 'do_game' 的工具，允许LLM客户端发送 "rock", "paper", 或 "scissors" 指令与服务器玩石头剪刀布游戏。
  • 基于MCP协议: 使用 '@modelcontextprotocol/sdk' 库构建，遵循MCP协议规范，能够与任何兼容MCP协议的客户端进行通信。
  • 标准输入/输出 (Stdio) 传输: 服务器通过标准输入和标准输出与客户端通信，易于集成和部署。

安装步骤

  1. 安装 Node.js: 确保你的电脑上已经安装了 Node.js 和 npm (Node.js 包管理器)。你可以从 https://nodejs.org/ 下载并安装。
  2. 克隆仓库: 使用 'git clone https://github.com/MCP-Mirror/yusukebe_my-first-mcp-server' 命令将仓库克隆到本地。
  3. 进入项目目录: 使用 'cd yusukebe_my-first-mcp-server' 命令进入项目目录。
  4. 安装依赖: 运行 'npm install' 命令安装项目所需的依赖包。
  5. 构建项目: 运行 'npm run build' 命令编译 TypeScript 代码到 JavaScript。

服务器配置

要将此MCP服务器配置到MCP客户端（例如 Claude），你需要提供服务器的启动命令。以下是配置信息，请根据你的实际环境进行调整：

{
  "mcpServers": {
    "game": {  // 服务器名称，客户端用此名称标识和连接服务器
      "command": "node", // 启动服务器的命令，这里使用 node.js 运行时
      "args": ["/path-to/build/index.js"] // 命令参数，指向编译后的服务器入口文件。你需要将 "/path-to/build/index.js" 替换为实际的 index.js 文件路径。
    }
  }
}

注意:

  • 你需要将上述 JSON 配置添加到你的 MCP 客户端的配置文件中。根据 'README.md' 提供的路径 '/Users/yusuke/Library/Application\ Support/Claude/claude_desktop_config.json'，这可能是 Claude 桌面应用的配置文件路径。
  • 请务必将 '"/path-to/build/index.js"' 替换为 实际的 'index.js' 文件路径。通常在项目根目录下的 'build' 文件夹中。例如，如果你的项目完整路径是 '/Users/yourname/my-first-mcp-server'，那么实际路径可能是 '"/Users/yourname/my-first-mcp-server/build/index.js"'。

基本使用方法

  1. 启动服务器: 在克隆的项目目录下，运行 'npm run start' 命令启动 MCP 服务器。这会在后台运行 'node build/index.js' 命令。
  2. 配置客户端: 将上面提供的服务器配置 JSON 添加到你的 MCP 客户端配置文件中，并确保路径配置正确。
  3. 在客户端中使用: 在兼容 MCP 协议的 LLM 客户端中，客户端应该能够检测到名为 "game" 的 MCP 服务器。你可以指示 LLM 调用名为 'do_game' 的工具，并提供参数 '{"choice": "rock"}'，'{"choice": "paper"}' 或 '{"choice": "scissors"}' 来与服务器进行石头剪刀布游戏。
  4. 查看结果: 服务器会返回 JSON 格式的响应，指示游戏结果。客户端会根据响应内容展示游戏结果。

例如，在 Claude 中，你可能会这样指示 Claude: '请使用 game 服务器的 do_game 工具，我的选择是 rock。'

客户端会将这个指令转换为 MCP 请求发送给服务器，服务器处理后返回游戏结果。

信息

分类

网页与API

访问项目