Sudoku100 for AI — MCP & Skill

用 Sudoku100 的 AI 原生工具链 — MCP Server 和 Skill Package 为您的 LLM 赋能。让任何 AI 模型通过自然语言或结构化函数调用来生成、嵌入和传递数独谜题。

MCP Server 用于 Claude / Cursor Skill Package 用于 OpenAI / LangChain 无需 API 密钥,100% 免费

快速开始

MCP Server

一条命令即可将 Claude Desktop、Cursor 或任何 MCP 兼容客户端连接到 Sudoku100 谜题服务。

npx -y sudoku-api-mcp
Claude Desktop 配置
{
  "mcpServers": {
    "sudoku": {
      "command": "npx",
      "args": ["-y", "sudoku-api-mcp"]
    }
  }
}

Skill Package

直接引入 Node.js 项目。支持 OpenAI Tool Calls、Claude tools、LangChain — 通用 LLM 函数调用。

npm install sudoku-api-skill
快速代码
const skill = require('sudoku-api-skill');

const tools = skill.getToolDefinition();
// → [{ type: "function", function: { ... } }]

const result = await skill.invoke({
  action: "generate_sudoku",
  difficulty: "medium",
  width: 400,
  format: "png"
});
// → { success: true, imageUrl: "...", puzzleId: 12345 }

MCP Server

Claude Desktop / Cursor 配置
{
  "mcpServers": {
    "sudoku": {
      "command": "npx",
      "args": ["-y", "sudoku-api-mcp"]
    }
  }
}

Model Context Protocol (MCP) 服务器,将数独生成直接带入任何兼容 MCP 的 AI 客户端。一次配置,永久生成谜题。

  • generate_sudoku 按难度生成数独谜题图片。6 个级别,从入门到极限。
  • get_sudoku_by_id 通过数字 ID 获取特定的数独谜题。相同 ID = 相同谜题。
  • list_difficulties 列出所有可用难度级别及提示数范围。

Skill Package

一个与 OpenAI 兼容的工具定义和执行器。将 sudoku_api 作为工具添加到任何支持函数/工具调用的 LLM 中 — OpenAI、Claude API、Gemini、LangChain 等。

兼容:OpenAI · Claude API · Gemini · LangChain · LlamaIndex
工具定义
const skill = require('sudoku-api-skill');

// Get OpenAI-compatible tool definition
const tools = skill.getToolDefinition();

console.log(JSON.stringify(tools, null, 2));

// Output:
[{
  "type": "function",
  "function": {
    "name": "generate_sudoku",
    "description": "Generate a Sudoku puzzle",
    "parameters": {
      "type": "object",
      "properties": {
        "difficulty": { "type": "string" },
        "width": { "type": "number" },
        "format": { "type": "string" }
      },
      "required": ["difficulty"]
    }
  }
}]
调用示例
const result = await skill.invoke({
  action: "generate_sudoku",
  difficulty: "medium",
  width: 400,
  format: "png"
});

// Result:
// {
//   success: true,
//   imageUrl: "https://sudoku100.com/...",
//   puzzleId: 12345,
//   difficulty: "medium"
// }

三种 AI 集成方式

选择最适合您工作流程的集成方法。

1

直接 URL

无需安装。只需将 Sudoku100 URL 粘贴到任何 AI 聊天或工具中。最简单的入门方式。

https://www.sudoku100.com/sudoku-img
2

MCP Server

最适合 Claude Desktop 和 Cursor 用户。一次安装,即可用自然语言让 AI 生成数独。

npx -y sudoku-api-mcp
3

Skill Package

面向构建 AI 应用的开发者。将 sudoku_api 作为函数工具添加到您的 LLM 管道中,支持完整参数控制。

npm install sudoku-api-skill

使用场景

AI 驱动的数独集成为各种应用开辟了新的可能。

AI 增强教育

让 LLM 为学生生成符合其水平的个性化数独练习题。非常适合数学拓展和逻辑训练。

智能内容创作

博主和新闻通讯作者可以让 AI 自动在文章和邮件中插入全新的数独谜题。

应用内游戏集成

用最少代码为数独应用增加谜题。AI 处理谜题生成,您专注于应用体验。

数据分析与测试

研究人员可以使用 LLM 批量生成具有受控难度分布的数独数据集用于研究。

聊天机器人丰富化

让您的聊天机器人更有趣,在对话中提供数独挑战作为轻松解压。

多智能体工作流

将数独生成与其他 MCP 工具结合,构建复杂的多步骤 AI 自动化流程。

为什么选择 Sudoku100 for AI?

为 AI 时代量身打造 — 我们的 MCP Server 和 Skill Package 使数独生成成为一流的 LLM 能力。

零认证

无需 API 密钥、无需注册、无需令牌。MCP 和 Skill 皆可开箱即用。非常适合需要无摩擦访问的 AI 智能体。

原生 MCP 设计

全 Model Context Protocol 支持。只需一个 JSON 配置块即可连接 Claude Desktop 或任何 MCP 客户端。

OpenAI Tool Call 兼容

Skill 包实现了标准的 OpenAI 函数调用模式。可用于任何支持工具/函数调用的 LLM。

保证唯一解

每道谜题都经过严格的求解算法验证。没有歧义或损坏的谜题 — AI 始终交付质量。

6 级难度

从入门到极限,6 个精细级别让 AI 能够根据用户需求精确调整谜题难度。

多种输出格式

PNG、WebP、SVG、JPG 格式,可自定义宽度(100-1000px)。AI 可以为任何场景选择最合适的格式。

确定性谜题 ID

get_sudoku_by_id 始终返回相同的谜题。非常适合可复现的 AI 输出和可分享的内容。

开源 & 永久免费

MIT 许可证。无使用限制,无隐藏费用。由 Sudoku100 社区为 AI 社区打造。

常见问题

MCP(Model Context Protocol)是 AI 客户端(如 Claude Desktop)自动发现和调用工具的协议。Skill 包是您引入自己代码中的 JavaScript 库,用于将数独添加为任何 LLM 管道的函数工具。如果您是 AI 客户端的终端用户,请使用 MCP;如果您是构建 AI 应用的开发者,请使用 Skill。

不需要,只需选择一种。MCP 适用于希望获得自然语言访问的 Claude Desktop/Cursor 用户。Skill 适用于将数独添加到自有 AI 应用的开发者。

是的!MCP 服务器完全免费,就像我们的公共 API 一样。无需注册或 API 密钥。

MCP Server:任何兼容 MCP 的客户端(Claude Desktop、Cursor、Continue 等)。Skill Package:OpenAI、Claude API、Gemini、LangChain、LlamaIndex,以及任何支持函数/工具调用的 LLM。

当然!MCP 和 Skill 都支持宽度(100-1000px)和格式(png、webp、svg、jpg)参数。调用工具时指定即可。

没有。MCP 和 Skill 使用没有速率限制。根据您的 AI 工作流需要生成任意数量的谜题。

MCP 服务器和 Skill 包均在 GitHub 上开源:github.com/sudoku100com-create/Sudoku-generate-API。欢迎 Star 和贡献!

再次运行 npx -y sudoku-api-mcp 即可 — -y 标志确保始终从 npm 获取最新版本。