用 Sudoku100 的 AI 原生工具链 — MCP Server 和 Skill Package 为您的 LLM 赋能。让任何 AI 模型通过自然语言或结构化函数调用来生成、嵌入和传递数独谜题。
快速开始
MCP Server
一条命令即可将 Claude Desktop、Cursor 或任何 MCP 兼容客户端连接到 Sudoku100 谜题服务。
npx -y sudoku-api-mcp {
"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
{
"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 · LlamaIndexconst 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 集成方式
选择最适合您工作流程的集成方法。
直接 URL
无需安装。只需将 Sudoku100 URL 粘贴到任何 AI 聊天或工具中。最简单的入门方式。
https://www.sudoku100.com/sudoku-img MCP Server
最适合 Claude Desktop 和 Cursor 用户。一次安装,即可用自然语言让 AI 生成数独。
npx -y sudoku-api-mcp 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 和 Skill 有什么区别?
MCP(Model Context Protocol)是 AI 客户端(如 Claude Desktop)自动发现和调用工具的协议。Skill 包是您引入自己代码中的 JavaScript 库,用于将数独添加为任何 LLM 管道的函数工具。如果您是 AI 客户端的终端用户,请使用 MCP;如果您是构建 AI 应用的开发者,请使用 Skill。
我需要同时使用 MCP 和 Skill 吗?
不需要,只需选择一种。MCP 适用于希望获得自然语言访问的 Claude Desktop/Cursor 用户。Skill 适用于将数独添加到自有 AI 应用的开发者。
MCP 服务器是免费的吗?
是的!MCP 服务器完全免费,就像我们的公共 API 一样。无需注册或 API 密钥。
支持哪些 AI 平台?
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 和贡献!
如何更新 MCP 服务器?
再次运行 npx -y sudoku-api-mcp 即可 — -y 标志确保始终从 npm 获取最新版本。