lego-oracle について
lego-oracleは、LEGOのセット、パーツ、ミニフィギュア、インベントリを検索するMCPサーバーです。ビルダーやコレクター向けにRebrickableのカタログデータを同梱し、実行時のネットワーク通信なしで照会できます。
主な機能
- 01名前、テーマ、年、ピース数でセット検索
- 02セットの詳細と共通パーツの比較
- 03カテゴリー、色、素材でパーツ検索
- 04ミニフィギュアと収録セットの確認
- 05テーマの閲覧と代替ビルドの検索
活用シーン
- 01テーマやピース数からセットを探す
- 02特定のパーツを含むセットを調べる
- 03セットごとのミニフィギュアを比較する
- 04セットのパーツを使った代替ビルドを探す
MCP 対応
MCP対応クライアントに、検索、照会、比較、発見のためのLEGOカタログツールを10種類提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
LEGO Oracle
LEGO セット、パーツ、ミニフィギュア、インベントリを扱う MCP サーバーです。
AI アシスタントに LEGO セットについて質問したり、特定のブロックを探したり、ミニフィギュアを検索したり、テーマを閲覧したり、セットを比較したりできます。幻覚ではなく、Rebrickable のカタログ(セット 26k 件、パーツ 62k 件、ミニフィギュア 17k 件)に基づいています。
ツールは 10 種類。設定不要。MCP 互換のあらゆる IDE で動作します。
インストール
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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。