谜题 MCP 服务指南

使用支持自定义 Bearer 请求头的客户端连接 Streamable HTTP 服务。API 密钥只放在请求头中，不能作为模型工具参数。

客户端配置

{
  "url": "https://puzzlegenio.com/api/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

客户端须支持远程 Streamable HTTP 和自定义 Authorization 请求头。只支持 OAuth 的客户端无法用这种认证方式连接。

创建工具

管理与图片工具

list_puzzles
get_puzzle
delete_puzzle
manage_puzzle_share
get_puzzle_capabilities
import_image_asset

工具调用示例

create_jigsaw

{
  "name": "create_jigsaw",
  "arguments": {
    "requestKey": "example-jigsaw-0001",
    "title": "Mountain puzzle",
    "options": {
      "tilesX": 5,
      "tilesY": 5,
      "shape": "rectangle"
    }
  }
}

create_crossword

{
  "name": "create_crossword",
  "arguments": {
    "requestKey": "example-crossword-0001",
    "title": "Nature crossword",
    "input": {
      "entries": [
        {
          "word": "RIVER",
          "clue": "A flowing body of water"
        },
        {
          "word": "TREE",
          "clue": "A woody plant"
        }
      ]
    }
  }
}

create_word_search

{
  "name": "create_word_search",
  "arguments": {
    "requestKey": "example-wordsearch-0001",
    "preset": "word-search-for-kids",
    "title": "Animal word search",
    "input": {
      "words": [
        "CAT",
        "DOG",
        "LION",
        "TIGER"
      ]
    },
    "options": {
      "gridSize": 10,
      "allowDiagonal": false
    }
  }
}

create_sudoku

{
  "name": "create_sudoku",
  "arguments": {
    "requestKey": "example-sudoku-0001",
    "title": "Sudoku practice",
    "options": {
      "size": 9,
      "difficulty": "easy",
      "count": 1
    }
  }
}

create_bingo

{
  "name": "create_bingo",
  "arguments": {
    "requestKey": "example-bingo-0001",
    "title": "Party bingo",
    "input": {
      "words": [
        "APPLE",
        "BANANA",
        "CHERRY",
        "DATE",
        "FIG",
        "GRAPE",
        "KIWI",
        "LEMON",
        "MANGO"
      ]
    },
    "options": {
      "gridSize": 3,
      "cardCount": 1
    }
  }
}

create_maze

{
  "name": "create_maze",
  "arguments": {
    "requestKey": "example-maze-0001",
    "title": "Simple maze",
    "options": {
      "cols": 10,
      "rows": 10,
      "algorithm": "backtracker"
    }
  }
}

create_nonogram

{
  "name": "create_nonogram",
  "arguments": {
    "requestKey": "example-nonogram-0001",
    "mode": "grid",
    "title": "Small nonogram",
    "input": {
      "grid": [
        [
          false,
          false,
          true,
          false,
          false
        ],
        [
          false,
          true,
          true,
          true,
          false
        ],
        [
          true,
          true,
          true,
          true,
          true
        ],
        [
          false,
          true,
          true,
          true,
          false
        ],
        [
          false,
          false,
          true,
          false,
          false
        ]
      ]
    }
  }
}

create_cryptogram

{
  "name": "create_cryptogram",
  "arguments": {
    "requestKey": "example-cryptogram-0001",
    "title": "Quote cipher",
    "input": {
      "text": "PRACTICE MAKES PROGRESS"
    },
    "options": {
      "difficulty": "easy"
    }
  }
}

create_word_scramble

{
  "name": "create_word_scramble",
  "arguments": {
    "requestKey": "example-scramble-0001",
    "title": "Animal scramble",
    "input": {
      "words": [
        "TIGER",
        "HORSE",
        "RABBIT"
      ]
    }
  }
}

图片输入

用 import_image_asset 导入可公开访问的 HTTPS 图片，再将返回的 assetId 传给支持图片的创建工具。二进制上传使用 POST /api/v1/assets。不要在模型参数中传入图片的 base64 内容。