卡牌魔术协议服务

卡片魔术mcp

中文文档

实现Chico&Dico卡魔术的模型上下文协议（MCP）服务器。

Chico&Dico牌魔术：随机抽取五张扑克牌，观众只需按照奇科安排的顺序背诵前四张牌，迪科就能知道第五张牌是什么。

你可以在 Smithery游乐场.

🎭 性能步骤

1. 告诉魔术师： Help me arrange these playing cards ♠J ♠4 ♣2 ♦3 ♦K
2. 这位魔术师会把牌分成两堆：前四张牌和第五张牌
3. 告诉另一个魔术师前四张牌是什么，他们就可以告诉你第五张牌是什麼： The first four playing cards are [card1 card2 card3 card4], what is the fifth card?

[！注意] 相信我，它不是通过记忆知道第五张牌是什么，而是通过纯粹的魔法。为了防止当前对话框记住第五张卡，您可以打开一个新的游乐场页面。告诉它前四张牌是什么，看看它是否还能猜对。

📦 安装

手动安装

pip install card-magic-mcp

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的Card Magic MCP服务器 史密瑟里:

npx -y @smithery/cli@latest install @luochang212/card-magic-mcp --client claude

🚀 用法

此MCP服务器可以与 Qwen代理商 使用两种连接方法： stdio 和 sse.

有关更多示例，请参见 examples/usage_remote.py

stdio：本地电话

将以下配置添加到 function_list 参数：

{
  "mcpServers": {
    "card_magic": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "card-magic-mcp",
        "card_magic_stdio"
      ]
    }
  }
}

sse：远程呼叫

调用之前，在命令行中运行以下代码以启动MCP服务：

HOST=0.0.0.0 PORT=8385 uvx --from card-magic-mcp card_magic_sse

将以下配置添加到 function_list:

{
  "mcpServers": {
    "card_magic_sse": {
      "url": "http://0.0.0.0:8385/sse"
    }
  }
}

🔧 可用工具

MCP服务器为卡片魔术提供了两个工具：

• encode_cards：对5张卡进行编码，将第5张卡的信息隐藏在前4张卡的排列中
• decode_cards：从前4张可见卡的排列信息中解码隐藏的第5张卡

🃏 卡片格式

• 套装: ♠ （黑桃）， ♥ （心）， ♦ （钻石）， ♣ （俱乐部）
• 等级: A，2，3，4，5，6，7，8，9，10，J，Q，K
• 格式：每张卡片应写为 {suit}{rank} 用空格分隔多张卡片