じゃんけんMCPサーバー

じゃんけんMCPサーバー

site icon
2025.04.23 0
TypeScript游戏服务娱乐功能娱乐功能
じゃんけんMCPサーバー是一个基于Model Context Protocol(MCP)的石头剪刀布游戏服务器。它允许LLM(大型语言模型)参与石头剪刀布游戏,或者获取随机的手势。该服务器提供了游戏逻辑处理、随机手势生成以及游戏规则说明等功能。
View on GitHub

Overview

基本能力

产品定位

じゃんけんMCPサーバー是一个娱乐性质的MCP服务器,专门用于提供石头剪刀布游戏功能。

核心功能

  1. 石头剪刀布游戏:支持玩家与AI进行石头剪刀布游戏,并返回游戏结果。
  2. 随机手势生成:AI可以随机生成石头、剪刀或布的手势。
  3. 游戏规则说明:提供石头剪刀布游戏规则的文本说明。

适用场景

  1. 在聊天机器人或虚拟助手中集成小游戏功能
  2. 用于演示MCP协议的功能
  3. 作为学习MCP服务器开发的示例项目

工具列表

  • play
  • 功能:进行石头剪刀布游戏
  • 输入:hand(字符串,必须是"グー"、"チョキ"或"パー"之一)
  • 输出:AI随机选择的手势和游戏结果

  • random

  • 功能:AI随机生成手势
  • 输入:无
  • 输出:AI随机选择的手势("グー"、"チョキ"或"パー")

常见问题解答

  1. 如何在不同环境中使用该服务器?
  2. 提供了Claude Desktop、NPX直接执行和VS Code三种使用方式

  3. 游戏规则在哪里查看?

  4. 可以通过访问janken://rules资源获取游戏规则说明

使用教程

使用依赖

  1. 确保已安装Node.js和npm
  2. 安装项目依赖:
npm install

安装教程

  1. 通过NPX直接运行:
npx mcp-janken-server
  1. 或者克隆项目后本地运行:
git clone <repository-url>
cd mcp-janken-server
npm install
npm run build
npm run start
  1. 在Claude Desktop中配置: 在claude_desktop_config.json的"mcpServers"部分添加配置

  2. 在VS Code中配置: 在用户设置或.vscode/mcp.json中添加配置

调试方式

  1. 开发模式运行(自动监视文件变化):
npm run dev
  1. 查看游戏逻辑:
# 使用curl或其他工具测试API
curl -X POST http://localhost:<port>/play -d '{"hand":"グー"}'

许可证

该项目遵循 None 开源许可条款。