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 分