纸牌游戏API服务

🃏 卡牌游戏MCP服务器

这个项目暴露了 deckofcardsapi.com 翻译为中文是“纸牌API网站”或“扑克牌API服务”。这里，“deckofcardsapi”指的是提供扑克牌相关API（应用程序编程接口）的网站名称，而“.com”是域名后缀，表示这是一个互联网上的商业或服务网站 通过构建的MCP服务器访问终端节点 FastMCP.

云托管链接： https://fastmcp.cloud/app/deck-of-cards 翻译为中文是：“https://fastmcp.cloud/app/抽牌游戏” 或者更流畅地表达为：“https://fastmcp.cloud/app/纸牌游戏应用”。这里，“deck-of-cards”通常指的是一个涉及抽牌或使用纸牌的游戏或应用，所以根据上下文，我将其翻译为“抽牌游戏”或“纸牌游戏应用”

本地设置

• 安装 紫外线 包管理器。
• 安装依赖项： uv sync
• 运行服务器： bash run.sh server
• 运行测试： bash run.sh tests

可用工具

• create_deck创建一个新牌组，可选择合并多个牌组。
• create_partial_deck构建一个仅限特定卡牌代码的牌组。
• shuffle_deck洗牌，可选择仅洗牌中剩余的牌。
• draw_cards从一副牌中抽取一张或多张牌。
• get_deck_state获取当前牌组的元数据。
• add_to_pile将指定的卡片移动到一个命名的堆中。
• draw_from_pile抽明牌，或使用 position (top， bottom， random（可选） count。
• list_pile_cards检查堆叠在一起的卡片。
• shuffle_pile将一堆牌洗一下。
• return_cards将牌组或牌堆中的卡片返回到主牌组中。

所有工具都将纸牌API的错误作为MCP进行传播 ToolError带有描述性信息的（情况/实例等）。

注

1. 不支持小丑（或：Joker 牌）。
2. 堆栈名称必须为1至32个字符，且只能使用字母、数字、连字符或下划线。
3. 纸牌魔术在使用多副牌时不起作用。