十字谜 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 服务器提供了以下工具（方法）。

工具名称	描述
setup	读取网格和线索定义，并初始化状态。
register_candidates	注册与字符数匹配的候选词。已有的候选词会被保留，重复的候选词将被忽略。
get_candidates	获取指定 clue_id 的候选词列表。
search_consistent_sets	从当前候选词中进行全搜索，寻找满足一致性的组合。
render_solution	将所有线索的答案（仅平假名）反映到盘面上，并绘制整理好的网格。
solve_crossword	通过组合上述工具提示来推进解谜过程。

在 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 License 下提供。 </中文翻译>