Lego Oracle

io.github.gregario由 GitHub 账号 gregario 发布v0.1.1更新于 Oct 25, 2026

LEGO sets, parts, minifigs, and inventories as an MCP server

已验证STDIO仅桌面知识与记忆数据与分析

概览

AI 生成的概览

一个本地 MCP 服务器，为助手提供离线的乐高套装、零件、人仔和主题目录，可搜索、查询和比较。

可以做什么
按名称、主题、年份或零件数搜索套装，获取含清单、人仔和主题层级的套装详情，或并排比较 2 到 4 个套装。按名称、类别、颜色或材质搜索零件，查看零件详情及颜色和模具/印刷变体，并查找哪些套装包含某零件。搜索人仔并获取其详情及出现的所有套装。浏览乐高主题层级，并查找某套装零件的社区另类拼搭方案。
适用场景
适合让助手基于真实目录而非猜测回答乐高问题：识别套装、查看套装内容、查找某个积木、查询人仔，或在购买或拼搭前比较套装。
运行要求
以 npm 包形式通过 npx 在本地运行，需要 Node.js。未声明任何配置、账号、API 密钥或环境变量；README 称数据在构建时内嵌，运行时无网络请求。仅支持桌面版 MCP 客户端。
安装前请注意
目录是构建时内嵌的快照，随新版本发布更新，很新的套装可能缺失。数据来自 Rebrickable，项目声明与乐高集团无关且未获其认可。工具均为只读查询，不涉及凭据或付款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Lego Oracle，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

LEGO Oracle

LEGO sets, parts, minifigs, and inventories. An MCP server.

[npm version] [npm downloads] [MIT Licence] [Node.js 18+] [MCP Compatible] [lego-oracle MCP server]

Ask your AI assistant about LEGO sets, find specific bricks, look up minifigures, browse themes, and compare sets. All backed by Rebrickable's catalog (26k sets, 62k parts, 17k minifigs), not hallucinations.

10 tools. Zero config. Works with every MCP-compatible IDE.

[lego-oracle MCP server] [gregario/lego-oracle MCP server]

Install

bash
npx -y lego-oracle

Add to your IDE

Claude Code
bash
claude mcp add lego-oracle -- npx -y lego-oracle
Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "lego-oracle": {      "command": "npx",      "args": ["-y", "lego-oracle"]    }  }}
Cursor

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "lego-oracle": {      "command": "npx",      "args": ["-y", "lego-oracle"]    }  }}
VS Code (Copilot)

Add to .vscode/mcp.json:

json
{  "servers": {    "lego-oracle": {      "command": "npx",      "args": ["-y", "lego-oracle"]    }  }}
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "lego-oracle": {      "command": "npx",      "args": ["-y", "lego-oracle"]    }  }}
Zed

Add to settings.json:

json
{  "context_servers": {    "lego-oracle": {      "command": {        "path": "npx",        "args": ["-y", "lego-oracle"]      }    }  }}

Tools

Set Tools

ToolDescription
search_setsSearch for sets by name, theme, year, or piece count. Full-text search with filters.
get_setGet complete set details: inventory (grouped by part category), minifigures, theme hierarchy.
compare_setsCompare 2-4 sets side by side: piece count, year, theme, minifigs, shared parts.

Part Tools

ToolDescription
search_partsSearch parts by name, category, colour, or material.
get_partGet part details including available colours and mold/print variants.
find_part_in_setsFind which sets contain a specific part (optionally in a specific colour), sorted by quantity.

Minifig Tools

ToolDescription
search_minifigsSearch minifigures by name.
get_minifigGet minifig details and every set it appears in.

Discovery Tools

ToolDescription
browse_themesBrowse the LEGO theme hierarchy. Top-level themes or drill into sub-themes with set counts.
find_mocsFind community alternate builds (MOCs) for a set's parts.

Data

All data is embedded at build time from Rebrickable. No network calls at runtime.

CategoryCount
Sets26,339
Parts61,702
Colours275
Minifigures16,646
Inventory entries1,483,652
Part relationships35,757
Themes490

Data is updated daily via GitHub Actions. New npm versions are published automatically when Rebrickable data changes.

Development

bash
npm installnpm run buildnpm test             # 141 tests

To refresh data from Rebrickable:

bash
npm run fetch-datanpm run build

Attribution

Data from Rebrickable. LEGO is a trademark of the LEGO Group. This project is not produced by or endorsed by the LEGO Group.

License

MIT

来源：README.md，提交 ef4087e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分