
じゃんけんMCPサーバー

2025.04.23
0
TypeScript游戏服务娱乐功能娱乐功能
じゃんけんMCPサーバー是一个基于Model Context Protocol(MCP)的石头剪刀布游戏服务器。它允许LLM(大型语言模型)参与石头剪刀布游戏,或者获取随机的手势。该服务器提供了游戏逻辑处理、随机手势生成以及游戏规则说明等功能。
View on GitHub
Overview
基本能力
产品定位
じゃんけんMCPサーバー是一个娱乐性质的MCP服务器,专门用于提供石头剪刀布游戏功能。
核心功能
- 石头剪刀布游戏:支持玩家与AI进行石头剪刀布游戏,并返回游戏结果。
- 随机手势生成:AI可以随机生成石头、剪刀或布的手势。
- 游戏规则说明:提供石头剪刀布游戏规则的文本说明。
适用场景
- 在聊天机器人或虚拟助手中集成小游戏功能
- 用于演示MCP协议的功能
- 作为学习MCP服务器开发的示例项目
工具列表
- play
- 功能:进行石头剪刀布游戏
- 输入:
hand
(字符串,必须是"グー"、"チョキ"或"パー"之一) -
输出:AI随机选择的手势和游戏结果
-
random
- 功能:AI随机生成手势
- 输入:无
- 输出:AI随机选择的手势("グー"、"チョキ"或"パー")
常见问题解答
- 如何在不同环境中使用该服务器?
-
提供了Claude Desktop、NPX直接执行和VS Code三种使用方式
-
游戏规则在哪里查看?
- 可以通过访问
janken://rules
资源获取游戏规则说明
使用教程
使用依赖
- 确保已安装Node.js和npm
- 安装项目依赖:
npm install
安装教程
- 通过NPX直接运行:
npx mcp-janken-server
- 或者克隆项目后本地运行:
git clone <repository-url>
cd mcp-janken-server
npm install
npm run build
npm run start
-
在Claude Desktop中配置: 在
claude_desktop_config.json
的"mcpServers"部分添加配置 -
在VS Code中配置: 在用户设置或
.vscode/mcp.json
中添加配置
调试方式
- 开发模式运行(自动监视文件变化):
npm run dev
- 查看游戏逻辑:
# 使用curl或其他工具测试API
curl -X POST http://localhost:<port>/play -d '{"hand":"グー"}'