Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_bridge_statusA

检查 CraftGraph 是否连上了 Minecraft、缓存了多少条配方、数据版本是多少。任何其他工具报错说连不上游戏时,先用这个确认状态。用户问「为什么查不到配方」时也先调这个。

refresh_recipesA

强制重新从游戏拉取配方并重建缓存。正常情况下不需要调用 —— 配方重载会被 dataVersion 自动检测到。只在用户明确说「我刚改了配方」或怀疑数据不对时用。

search_itemsA

按名称或 id 搜索物品,返回匹配的 id 列表。用户说「铁锭」「iron」这类模糊说法时,用它确定准确的物品 id,再拿去调配方查询工具。不需要游戏在运行。

get_registryA

列出 blocks / items / fluids / entities / recipe_types 注册表的内容。需要游戏在运行 —— 如果只是想找物品 id,优先用 search_items(它读本地缓存,离线也能用)。

list_recipe_typesA

列出这个整合包里存在的全部配方类型及各自的配方数量。用户问「这包里有哪些机器/配方类型」时用,也用来判断某个模组的配方有没有被读出来。

get_recipes_for_outputA

查询所有能产出指定物品的配方。用户问「X 怎么做」「X 怎么来的」时用这个。会同时返回读不懂的配方(标记 opaque),因为「有配方但读不懂」和「没有配方」是两回事。

get_recipes_for_inputA

查询所有把指定物品当作输入的配方。用户问「X 有什么用」「X 能做什么」时用。已正确处理标签:用 #forge:ingots/iron 这类标签作输入的配方也会被算进来。

get_recipe_detailsA

按 id 获取配方的完整输入输出、耗时、耗能。需要先通过其他查询拿到具体配方 id。要看多条时用 recipeIds 一次传(最多 20 条)—— 逐条调用会让往返次数随配方数线性增长。

find_alternative_recipesB

找出同一物品的所有其他做法,并比较它们的原料和耗时,帮助用户选一条。用户问「还有别的做法吗」「哪条更省」时用。

build_recipe_treeA

递归展开一个物品的完整制作链,列出每一层需要什么、需要做几次,并汇总基础原料。用户问「X 怎么做出来的」「做 X 需要哪些原料」时首选这个工具。结果已经处理了循环配方、标签选择、概率产出,并说明所有不确定的地方。

默认只展示前 3 层结构(更深的分支用「⋯」标出节点数和原料),但基础原料是完整的 —— 未展开的分支也已计算在内。要看某个分支的细节,把 detailDepth 调大,或者直接拿那个物品再调用一次本工具。

calculate_production_planA

给定目标产量(每分钟多少个),算出需要哪些机器各多少台、每分钟消耗多少原料、产出多少副产、总耗能。用户问「我要每分钟 X 个 Y,怎么建产线」时用。注意这是贪心近似:每种物品固定选一条配方(报告里会说明选路判据和落选候选),副产只统计不回代。

顶部那几张汇总表(机器/原料/副产/能耗)才是重点,逐环节明细默认只展示前 3 层。

expand_tagA

列出某个标签包含的所有物品。配方的输入里出现 #xxx 时,用这个看它到底可以是哪些东西。想知道某物品属于哪些标签,用 search_items 或 get_recipes_for_output 的结果。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 12 tools

Disambiguation4/5

Most tools have clearly distinct roles: status check, cache refresh, item search, registry listing, and recipe-type listing are all unambiguous. The recipe query group has mild overlap — get_recipes_for_output, find_alternative_recipes, and build_recipe_tree all answer 'how to make X' — but the descriptions carefully differentiate them by scope (raw recipe list vs. comparison vs. recursive tree).

Naming Consistency5/5

Every tool uses consistent snake_case verb-first naming (get_, list_, search_, find_, build_, calculate_, expand_, refresh_). The pattern is predictable and readable throughout, with no camelCase or mixed conventions.

Tool Count5/5

Twelve tools sit squarely in the well-scoped range and each earns its place, covering status, search, querying, and planning without redundancy.

Completeness5/5

Covers the full recipe-querying lifecycle: connection status, cache refresh, item search, registry and recipe-type listing, input/output recipe lookup, detailed recipe data, alternative comparison, recursive crafting trees, production planning, and tag expansion. Minor gap would be a direct item-detail tool, but search_items and expand_tag effectively bridge that.

Maintenance

ActivityMaintained
ResponsivenessNo issues