mcpField
L
lego-oracle

lego-oracle

本地服务
github.com/gregario游戏娱乐413 周前更新
代码仓库

关于 lego-oracle

lego-oracle 是用于查询 LEGO 套装、零件、人仔和库存的 MCP 服务。它面向积木爱好者与收藏者，内置 Rebrickable 目录数据，运行时无需联网查询。

主要功能

  1. 01按名称、主题、年份或零件数搜索套装
  2. 02比较套装详情与共有零件
  3. 03按类别、颜色或材质搜索零件
  4. 04查询人仔及其所属套装
  5. 05浏览主题并查找替代搭建

适用场景

  1. 01按主题或零件数寻找套装
  2. 02查询哪些套装包含指定积木
  3. 03比较不同套装中的人仔
  4. 04探索使用套装零件的替代搭建

MCP 相关

向兼容 MCP 的客户端提供 10 个 LEGO 目录工具，包括搜索、查询、比较和发现功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "gregario-lego-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "lego-oracle"
      ]
    }
  }
}
启动命令npx -y lego-oracle

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmlego-oracle0.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

LEGO Oracle

LEGO 套装、零件、人仔和库存。一个 MCP 服务。

npm 版本 npm 下载量 MIT 许可证 Node.js 18+ 兼容 MCP lego-oracle MCP 服务

向 AI 助手咨询 LEGO 套装、查找特定积木、查询人仔、浏览主题并比较套装。所有数据均来自 Rebrickable 目录（26k 个套装、62k 个零件、17k 个人仔），而非幻觉内容。

10 个工具。零配置。适用于所有兼容 MCP 的 IDE。

lego-oracle MCP server gregario/lego-oracle MCP server

安装

npx -y lego-oracle
添加到 IDE
Claude Code 
claude mcp add lego-oracle -- npx -y lego-oracle
Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%/Claude/claude_desktop_config.json（Windows）：

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

添加到 .cursor/mcp.json：

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

添加到 .vscode/mcp.json：

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

添加到 ~/.codeium/windsurf/mcp_config.json：

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

添加到 settings.json：

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

工具

套装工具
工具描述
search_sets按名称、主题、年份或零件数量搜索套装。支持全文搜索和筛选。
get_set获取套装完整详情：库存（按零件类别分组）、人仔和主题层级。
compare_sets并排比较 2-4 个套装：零件数量、年份、主题、人仔和共有零件。
零件工具
工具描述
search_parts按名称、类别、颜色或材质搜索零件。
get_part获取零件详情，包括可用颜色以及模具／印刷变体。
find_part_in_sets查找包含特定零件的套装（可选指定颜色），并按数量排序。
人仔工具
工具描述
search_minifigs按名称搜索人仔。
get_minifig获取人仔详情及其出现过的所有套装。
探索工具
工具描述
browse_themes浏览 LEGO 主题层级。查看顶级主题，或深入子主题并查看套装数量。
find_mocs查找使用某套装零件的社区替代拼搭作品（MOC）。

数据

所有数据均在构建时从 Rebrickable 嵌入。运行时不会发起网络请求。

类别数量
套装26,339
零件61,702
颜色275
人仔16,646
库存条目1,483,652
零件关系35,757
主题490

数据通过 GitHub Actions 每日更新。Rebrickable 数据发生变化时，会自动发布新的 npm 版本。

开发

npm install
npm run build
npm test             # 141 tests

从 Rebrickable 刷新数据：

npm run fetch-data
npm run build

归属声明

数据来自 Rebrickable。LEGO 是 LEGO Group 的商标。本项目并非由 LEGO Group 制作或认可。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。