MCP Crossword Tools

🚀 填字遊戲MCP服務器

本倉庫是一個填字遊戲輔助MCP服務器。它可以讀取包含棋盤和線索定義的文本文件，實現候選詞的註冊、一致性檢查以及最終棋盤的繪製等功能。

🚀 快速開始

必要環境

• Python 3.11 及以上版本
• uv

由於依賴項會通過 uv run 進行安裝，因此無需提前手動使用 pip install 進行安裝。

數據形式

• 棋盤文件 (data/grid-*.txt)
  • 用全角數字標註行號和列號。
  • 可輸入的格子用全角的「？」表示。
  • 黑色格子用全角的「＃」表示。
• 線索文件 (data/clue-*.txt)
  • 採用一行一條記錄的 JSON Lines 格式。
  • 需指定 id、direction（"across" / "down"）、row、col、length 和 clue 所有字段。

data/ 文件夾中提供了示例棋盤和線索文件對。若要解決其他問題，請參考這些文件創建棋盤和線索文件。

提供工具

MCP 服務器提供以下工具（方法）：

Claude Code 註冊與使用方法

要將本服務器添加到 Claude Code 中，請在項目根目錄下執行以下命令：

claude mcp add crossword_tools --scope project -- uv run --with fastmcp fastmcp run src/server.py

（crossword_tools 是賦予此服務器的 MCP 名稱，可根據需要進行更改）

註冊完成後，在 Claude Code 中選擇自定義斜槓命令 /crossword_tools，並指定棋盤和線索文件（或文本）作為參數。Claude Code 將按照提示自動進行狀態初始化、候選詞添加和一致性檢查，若得出最終答案，還會繪製答案並生成報告。

/crossword_tools:solve_crossword (MCP) grid-001.txt clue-001.txt

📄 許可證

本倉庫在 MIT 許可證下發布。