feat(redstone): connect minecraft.wiki via three new MCP tools
Redstone can now query the official Minecraft wiki and deliver crafting recipe / item images straight into the chat. New: mcp/lib/minecraft-wiki-tools.ts exports three tools, all hitting https://minecraft.wiki/api.php (MediaWiki API, formatversion=2): - wiki_search(query, limit?) — opensearch top results, namespace 0, returns { title, description, url } for each hit. - wiki_page(title, thumb_size?) — extracts|pageimages → intro extract (plain text, ~600 chars) + thumbnail_url + page_url. - wiki_page_images(title, filter?, limit?) — generator=images + prop=imageinfo (iiprop=url|mime|size) returns every image embedded on the page along with its direct https URL. The `filter` substring is case-insensitive against the filename — pass 'recipe' / 'craft' / 'grid' to surface crafting-recipe diagrams. Bot wiring (bot/bot.ts): - import minecraftWikiTools, merge into allTools so it flows through the existing OpenRouter + Gemini function/tool schemas automatically. - Persona prompt teaches the model the canonical flow: wiki_search → wiki_page → wiki_page_images(filter='recipe') → tg_send_photo(url, caption). Composes with the already-existing tg_send_photo tool — no new telegram tool needed. User-Agent on every wiki request, 15s timeout, JSON-only. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
146
mcp/lib/minecraft-wiki-tools.ts
Normal file
146
mcp/lib/minecraft-wiki-tools.ts
Normal file
@@ -0,0 +1,146 @@
|
||||
// Minecraft Wiki tool catalog. Hits https://minecraft.wiki (MediaWiki API).
|
||||
// Composes well with telegram-tools.ts → after wiki_page_images returns a URL
|
||||
// the model can pass it to tg_send_photo to surface a recipe / item image
|
||||
// directly into the chat.
|
||||
import { z } from "zod";
|
||||
import { tool, type Tool } from "./types.ts";
|
||||
|
||||
const WIKI_BASE = "https://minecraft.wiki";
|
||||
const WIKI_API = `${WIKI_BASE}/api.php`;
|
||||
const UA = "Redstone-bot/1.0 (Minecraft container; contact via telegram bot)";
|
||||
const TIMEOUT_MS = 15_000;
|
||||
|
||||
async function wikiGet<T>(params: Record<string, string | number | undefined>): Promise<T> {
|
||||
const url = new URL(WIKI_API);
|
||||
url.searchParams.set("format", "json");
|
||||
url.searchParams.set("formatversion", "2");
|
||||
for (const [k, v] of Object.entries(params)) {
|
||||
if (v !== undefined) url.searchParams.set(k, String(v));
|
||||
}
|
||||
const res = await fetch(url.toString(), {
|
||||
headers: { "User-Agent": UA, Accept: "application/json" },
|
||||
signal: AbortSignal.timeout(TIMEOUT_MS),
|
||||
});
|
||||
if (!res.ok) throw new Error(`wiki ${res.status}: ${(await res.text()).slice(0, 200)}`);
|
||||
return (await res.json()) as T;
|
||||
}
|
||||
|
||||
function pageUrl(title: string): string {
|
||||
return `${WIKI_BASE}/w/${encodeURIComponent(title.replace(/ /g, "_"))}`;
|
||||
}
|
||||
|
||||
export const minecraftWikiTools: Tool<z.ZodRawShape>[] = [
|
||||
tool({
|
||||
name: "wiki_search",
|
||||
title: "Search the Minecraft wiki",
|
||||
description:
|
||||
"Search minecraft.wiki for pages matching a query. Returns top matches with title, short description, and canonical page URL. Use this first to find the exact page title before calling wiki_page or wiki_page_images.",
|
||||
parameters: {
|
||||
query: z.string().min(1).describe("Search terms, e.g. 'iron pickaxe', 'crafting table', 'beacon'"),
|
||||
limit: z.number().int().min(1).max(15).optional().describe("Max results (default 5)"),
|
||||
},
|
||||
handler: async ({ query, limit }) => {
|
||||
// opensearch returns a 4-tuple: [query, titles[], descriptions[], urls[]]
|
||||
type OpenSearch = [string, string[], string[], string[]];
|
||||
const data = await wikiGet<OpenSearch>({
|
||||
action: "opensearch",
|
||||
search: query,
|
||||
limit: limit ?? 5,
|
||||
namespace: 0,
|
||||
});
|
||||
const [, titles, descriptions, urls] = data;
|
||||
return {
|
||||
results: titles.map((title, i) => ({
|
||||
title,
|
||||
description: descriptions[i] || "",
|
||||
url: urls[i] || pageUrl(title),
|
||||
})),
|
||||
};
|
||||
},
|
||||
}),
|
||||
|
||||
tool({
|
||||
name: "wiki_page",
|
||||
title: "Get a Minecraft wiki page summary",
|
||||
description:
|
||||
"Fetch the intro extract (plain text) plus the page's thumbnail image URL and canonical URL. Good for a one-line answer about an item, mob, or mechanic, plus a representative image to send.",
|
||||
parameters: {
|
||||
title: z.string().min(1).describe("Exact wiki page title (use wiki_search first if unsure)"),
|
||||
thumb_size: z.number().int().min(120).max(1200).optional().describe("Thumbnail pixel width (default 600)"),
|
||||
},
|
||||
handler: async ({ title, thumb_size }) => {
|
||||
type PageRes = {
|
||||
query?: {
|
||||
pages?: {
|
||||
title: string;
|
||||
missing?: boolean;
|
||||
extract?: string;
|
||||
thumbnail?: { source: string; width: number; height: number };
|
||||
pageimage?: string;
|
||||
}[];
|
||||
};
|
||||
};
|
||||
const data = await wikiGet<PageRes>({
|
||||
action: "query",
|
||||
prop: "extracts|pageimages",
|
||||
titles: title,
|
||||
exintro: "1",
|
||||
explaintext: "1",
|
||||
exchars: 600,
|
||||
piprop: "thumbnail|name",
|
||||
pithumbsize: thumb_size ?? 600,
|
||||
redirects: "1",
|
||||
});
|
||||
const page = data.query?.pages?.[0];
|
||||
if (!page || page.missing) return { error: `no wiki page titled '${title}'` };
|
||||
return {
|
||||
title: page.title,
|
||||
extract: page.extract ?? "",
|
||||
thumbnail_url: page.thumbnail?.source ?? null,
|
||||
page_url: pageUrl(page.title),
|
||||
};
|
||||
},
|
||||
}),
|
||||
|
||||
tool({
|
||||
name: "wiki_page_images",
|
||||
title: "List images on a Minecraft wiki page (with full URLs)",
|
||||
description:
|
||||
"Returns every image embedded on a wiki page along with its direct https URL. Use the optional `filter` to narrow by filename substring (case-insensitive) — pass 'recipe' or 'craft' or 'grid' to surface crafting-recipe diagrams. Hand a URL from this result to tg_send_photo to deliver the image into a chat.",
|
||||
parameters: {
|
||||
title: z.string().min(1).describe("Exact wiki page title"),
|
||||
filter: z.string().optional().describe("Case-insensitive substring filter on the filename (e.g. 'recipe', 'craft', 'grid')"),
|
||||
limit: z.number().int().min(1).max(50).optional().describe("Max images to return (default 20)"),
|
||||
},
|
||||
handler: async ({ title, filter, limit }) => {
|
||||
type ImgRes = {
|
||||
query?: {
|
||||
pages?: {
|
||||
title: string;
|
||||
imageinfo?: { url: string; mime?: string; width?: number; height?: number }[];
|
||||
}[];
|
||||
};
|
||||
};
|
||||
const data = await wikiGet<ImgRes>({
|
||||
action: "query",
|
||||
generator: "images",
|
||||
titles: title,
|
||||
prop: "imageinfo",
|
||||
iiprop: "url|mime|size",
|
||||
gimlimit: 50,
|
||||
redirects: "1",
|
||||
});
|
||||
const pages = data.query?.pages ?? [];
|
||||
let images = pages.map((p) => ({
|
||||
filename: p.title.replace(/^File:/, ""),
|
||||
url: p.imageinfo?.[0]?.url ?? "",
|
||||
mime: p.imageinfo?.[0]?.mime,
|
||||
})).filter((i) => i.url && (!i.mime || i.mime.startsWith("image/")));
|
||||
if (filter) {
|
||||
const needle = filter.toLowerCase();
|
||||
images = images.filter((i) => i.filename.toLowerCase().includes(needle));
|
||||
}
|
||||
return { images: images.slice(0, limit ?? 20) };
|
||||
},
|
||||
}),
|
||||
];
|
||||
Reference in New Issue
Block a user