card-magic-mcp 1.0.7

A Model Context Protocol (MCP) server that implements the famous Chico and Dico card magic trick algorithm. This server enables AI assistants to perform mathematical card magic by encoding and decoding card sequences based on combinatorial principles. The magic works by using the first 4 cards to predict the 5th card from any randomly selected 5-card hand, leveraging factorial number systems and permutation mathematics.

card-magic-mcp

中文文档

A Model Context Protocol (MCP) server that implements the Chico & Dico card magic trick.

Chico & Dico's Card Magic: Randomly draw five playing cards, and the audience only needs to recite the first four cards in the order arranged by Chico, and Dico can know what the fifth card is.

📦 Installation

Manual Installation

pip install card-magic-mcp

Installing via Smithery

To install Card Magic MCP Server for Claude Desktop automatically via Smithery:

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

🚀 Usage

Can be called through Qwen Agent, supporting two calling methods: stdio and sse. See examples/usage_remote.py for usage examples.

1. stdio Local Call

Add the following configuration to the function_list parameter:

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

2. sse Remote Call

Before calling, run the following code in the command line to start the MCP service:

uvx --from card-magic-mcp card_magic_sse

Add the following configuration to function_list:

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

🔧 Available Tools

The MCP Server provides two tools for card magic:

• encode_cards: Encode 5 cards to hide the 5th card's information in the arrangement of the first 4 cards
• decode_cards: Decode the hidden 5th card from the arrangement information of the first 4 visible cards

🃏 Card Format

• Suits: ♠ (Spades), ♥ (Hearts), ♦ (Diamonds), ♣ (Clubs)
• Ranks: A，2，3，4，5，6，7，8，9，10，J，Q，K
• Format: Each card should be written as {suit}{rank} with spaces separating multiple cards