@goodfellow-cms/mcp 0.4.0 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 Work on a [Goodfellow](https://goodfellow-cms.github.io/goodfellow-cms/) site from Claude. An [MCP](https://modelcontextprotocol.io) server with Goodfellow's tools: Claude reads a site's pages, items and settings, sees what blocks it has, makes changes in a draft, takes screenshots, and publishes the draft or submits it for review.
 
-See [Work with Claude](https://goodfellow-cms.github.io/goodfellow-cms/docs/claude) for setting it up. This package runs the tools on your own computer, signed in with a GitHub or GitLab token that stays there.
+See [Work with Claude](https://goodfellow-cms.github.io/goodfellow-cms/docs/claude) for setting it up. This package runs the tools on your own computer, signed in with a GitHub, GitLab or Bitbucket token that stays there.
 
 ## Claude Code
 

package/dist/index.d.ts

@@ -56,10 +56,10 @@ export declare const INSTRUCTIONS = "These tools edit websites built with Goodfe
 //#endregion
 //#region src/index.d.ts
 /** A site's id for the tools: its host, then its repository, such as `github:parish/site`. */
-export type SiteId = `github:${string}` | `gitlab:${string}`;
+export type SiteId = `github:${string}` | `gitlab:${string}` | `bitbucket:${string}`;
 /** Splits a site's id into its host and repository, or `undefined` if it isn't one. */
 export declare function parseSiteId(id: string): {
-  host: "github" | "gitlab";
+  host: "github" | "gitlab" | "bitbucket";
   repo: string;
 } | undefined;
 /** An MCP server with Goodfellow's tools. Connect it to a transport. */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { COLLECTIONS_DIR, COLLECTION_SETTINGS_FILE, ConflictError, DraftError, FOOTER_FILE, GOODFELLOW_VERSION, HEADER_FILE, MEDIA_DIR, MEDIA_FILE, MENUS_FILE, PAGES_DIR, SITE_DESCRIPTION_PATH, SITE_FILE, SignInError, collectionFileSchema, entryAddress, entryFieldProblems, entryFileChange, isAddressSegment, isEmptyValue, isReservedPagePath, layoutFileChange, layoutFileSchema, mediaFileSchema, menusFileChange, menusFileSchema, newDraftName, normalizePagePath, pageFileChange, pageFileSchema, pageFileToPath, pagePathToFile, parseContentFile, parseEntryFile, parseSiteDescription, readTextFiles, siteSettingsFileChange, siteSettingsSchema, siteVersionProblem, writeChanges } from "@goodfellow-cms/core";
+import { COLLECTIONS_DIR, COLLECTION_SETTINGS_FILE, ConflictError, DraftError, FOOTER_FILE, GOODFELLOW_VERSION, HEADER_FILE, MEDIA_DIR, MEDIA_FILE, MENUS_FILE, PAGES_DIR, SITE_DESCRIPTION_PATH, SITE_FILE, SignInError, collectionFileSchema, describedConfig, entryFieldProblems, entryFileChange, entryPathIn, hasLanguages, isAddressSegment, isEmptyValue, isOtherLanguage, isReservedPagePath, layoutFileChange, layoutFileSchema, mainLanguage, mediaFileSchema, menusFileChange, menusFileSchema, newDraftName, normalizePagePath, pageFileChange, pageFileSchema, pageFileToPath, pagePathToFile, parseContentFile, parseEntryFile, parseSiteDescription, readTextFiles, siteLanguages, siteSettingsFileChange, siteSettingsSchema, siteVersionProblem, writeChanges } from "@goodfellow-cms/core";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { cleanProps, objectSchema, slotNames, toContent, toFlatBlocks } from "@goodfellow-cms/ai/schema";
 import { z } from "zod";
@@ -21,9 +21,18 @@ async function readSettings(source) {
 	const text = await source.read(SITE_FILE);
 	return text === void 0 ? siteSettingsSchema.parse({ version: 1 }) : parsed(parseContentFile("site", siteSettingsSchema, SITE_FILE, text));
 }
+/** The site's menus, and the ones of its other languages that have menus of their own. */
 async function readMenus(source) {
 	const text = await source.read(MENUS_FILE);
-	return text === void 0 ? {} : parsed(parseContentFile("menus", menusFileSchema, MENUS_FILE, text)).menus;
+	if (text === void 0) return {
+		menus: {},
+		languageMenus: {}
+	};
+	const file = parsed(parseContentFile("menus", menusFileSchema, MENUS_FILE, text));
+	return {
+		menus: file.menus,
+		languageMenus: file.languages ?? {}
+	};
 }
 async function readLayout(source, part) {
 	const file = part === "header" ? HEADER_FILE : FOOTER_FILE;
@@ -106,17 +115,46 @@ async function readEntry(source, collection, slug) {
 	};
 }
 /**
+* Each item's language, by its name. Only a site with other languages has
+* items in them, so only then are the items' files read, all in one go where
+* the source can.
+*/
+async function entryLanguages(source, collection, site) {
+	const main = mainLanguage(site);
+	if (!hasLanguages(site)) return new Map(collection.entries.map((entry) => [entry.slug, main]));
+	const texts = await readTextFiles(source, collection.entries.map((entry) => entry.file));
+	return new Map(collection.entries.map((entry) => {
+		const text = texts.get(entry.file);
+		const file = text === void 0 ? void 0 : parseEntryFile(collection.settings, entry.file, text);
+		return [entry.slug, file?.ok && file.value.inLanguage || main];
+	}));
+}
+/** Each item's address, by its name, in its language, where its collection gives items pages. */
+async function entryAddresses(source, collection, site) {
+	if (collection.settings.path === void 0) return /* @__PURE__ */ new Map();
+	const languages = await entryLanguages(source, collection, site);
+	return new Map(collection.entries.flatMap((entry) => {
+		const path = entryPathIn(site, collection.settings, entry.slug, languages.get(entry.slug) ?? mainLanguage(site));
+		return path === void 0 ? [] : [[entry.slug, path]];
+	}));
+}
+/**
 * Every address the site's pages and entries have, so a new page or entry
-* never takes one. Entries' addresses come from their collections' settings.
+* never takes one. Entries' addresses come from their collections' settings,
+* and in a site with other languages, their own languages.
 */
 async function takenAddresses(source) {
 	const addresses = new Set((await listPages(source)).map((page) => page.address));
+	const site = await readSettings(source);
 	for (const collection of await listCollections(source)) {
 		const text = await source.read(collection.file);
 		if (text === void 0) continue;
 		const settings = parseContentFile("collection", collectionFileSchema, collection.file, text);
 		if (!settings.ok || settings.value.path === void 0) continue;
-		for (const entry of collection.entries) addresses.add(entryAddress(settings.value.path, entry.slug));
+		for (const address of (await entryAddresses(source, {
+			...collection,
+			settings: settings.value
+		}, site)).values()) addresses.add(address);
 	}
 	return addresses;
 }
@@ -163,17 +201,6 @@ async function contentFiles(source) {
 * description its build published (`goodfellow-site.json`), which says what
 * blocks it has, since the connector doesn't have the site's code.
 */
-function configFrom(description, templates) {
-	return {
-		components: Object.fromEntries(Object.entries(description.blocks).filter(([, block]) => templates || !block.templateOnly).map(([name, block]) => [name, {
-			...block.label && { label: block.label },
-			fields: block.fields,
-			...block.defaultProps && { defaultProps: block.defaultProps },
-			render: () => null
-		}])),
-		root: { fields: description.root.fields }
-	};
-}
 const VERSION_PROBLEMS = {
 	"site-too-old": (site) => `The site was built with Goodfellow ${site}, which is too old for Claude to change it. Ask the site's owner to update it on the admin panel's Updates screen; reading it still works.`,
 	"tool-too-old": (site) => `The site was built with Goodfellow ${site}, which is newer than this connector (${GOODFELLOW_VERSION}). Update the connector to change it; reading it still works.`
@@ -195,8 +222,8 @@ async function openSite(context, id) {
 		settings,
 		url,
 		description,
-		pageConfig: configFrom(description, false),
-		templateConfig: configFrom(description, true),
+		pageConfig: describedConfig(description, "page"),
+		templateConfig: describedConfig(description, "template"),
 		...problem && { versionProblem: VERSION_PROBLEMS[problem](description.goodfellow) }
 	};
 }
@@ -221,6 +248,7 @@ const INSTRUCTIONS = `These tools edit websites built with Goodfellow, for peopl
 /** Why `publish` refuses, on sites whose config says `claude: { publish: false }`. */
 const NO_PUBLISHING = "The site's owner has turned off publishing from Claude. Submit the draft for review instead (submit_for_review), and someone who looks after the site publishes it.";
 const siteArg = z.string().optional().describe("Which site, from list_sites. Leave it out when there's only one.");
+const languageArg = z.string().optional().describe("On a site in several languages, the code of a language from get_site. Leave it out for the main language.");
 const draftArg = z.string().optional().describe("The draft, as an earlier change returned it. To read: leave it out for the live site. To change: leave it out to start a new draft.");
 const flatBlock = z.object({
 	type: z.string().describe("The block's name, from get_blocks."),
@@ -355,7 +383,12 @@ function registerTools(server, context) {
 				id: collection.id,
 				entries: collection.entries.length
 			})),
-			menus: Object.keys(menus),
+			menus: Object.keys(menus.menus),
+			...hasLanguages(site.settings) && { languages: siteLanguages(site.settings).map((language) => ({
+				code: language.code,
+				name: language.name,
+				...language.main ? { main: true } : { pagesUnder: language.prefix }
+			})) },
 			blocks: Object.entries(site.description.blocks).map(([name, block]) => ({
 				name,
 				...block.label && { label: block.label },
@@ -431,7 +464,7 @@ function registerTools(server, context) {
 			content: built.content
 		};
 		const title = typeof props.title === "string" && props.title ? props.title : path;
-		await save(draft, [pageFileChange(path, data)], `${existing ? "Update" : "Add"} page "${title}"`);
+		await save(draft, [pageFileChange(path, data, existing?.content)], `${existing ? "Update" : "Add"} page "${title}"`);
 		return text({
 			draft: draft.name,
 			address: path,
@@ -498,8 +531,12 @@ function registerTools(server, context) {
 		collection: z.string().describe("The collection's id, from get_site."),
 		draft: draftArg
 	}, async ({ site: given, collection: id, draft }) => {
-		const collection = await readCollection(await reading(await open(given), draft), id);
+		const source = await reading(await open(given), draft);
+		const collection = await readCollection(source, id);
 		const { settings } = collection;
+		const siteSettings = await readSettings(source);
+		const [languages, addresses] = await Promise.all([entryLanguages(source, collection, siteSettings), entryAddresses(source, collection, siteSettings)]);
+		const several = hasLanguages(siteSettings);
 		return text({
 			id,
 			name: settings.name,
@@ -509,7 +546,8 @@ function registerTools(server, context) {
 			fields: settings.fields,
 			items: collection.entries.map((entry) => ({
 				slug: entry.slug,
-				...settings.path !== void 0 && { address: entryAddress(settings.path, entry.slug) }
+				...addresses.has(entry.slug) && { address: addresses.get(entry.slug) },
+				...several && { language: languages.get(entry.slug) }
 			}))
 		});
 	}, true);
@@ -533,14 +571,19 @@ function registerTools(server, context) {
 		collection: z.string(),
 		slug: z.string().describe("The item's name in its address and file: lowercase letters, numbers and hyphens, such as open-day."),
 		values: z.record(z.string(), z.unknown()).describe("Field values, by the fields' names from get_collection."),
+		language: z.string().optional().describe("For a new item on a site in several languages, the code of the language it's in, from get_site. Leave it out for the site's main language. Names are the collection's whatever an item's language, so a translation has a name of its own."),
 		draft: draftArg
-	}, async ({ site: given, collection: id, slug, values, draft: name }) => {
+	}, async ({ site: given, collection: id, slug, values, language, draft: name }) => {
 		const draft = await changing(await open(given), name);
 		const collection = await readCollection(draft.store, id);
 		const existing = await readEntry(draft.store, collection, slug);
+		const siteSettings = await readSettings(draft.store);
+		if (language !== void 0 && existing && language !== (existing.content.inLanguage ?? mainLanguage(siteSettings))) throw new ToolError(`An item's language can't change. Save the translation as an item of its own.`);
+		if (language !== void 0 && language !== mainLanguage(siteSettings) && !isOtherLanguage(siteSettings, language)) throw new ToolError(`${language} isn't one of the site's languages. get_site lists them.`);
+		const inLanguage = language !== void 0 && language !== mainLanguage(siteSettings) ? language : void 0;
 		if (!existing) {
 			if (!isAddressSegment(slug)) throw new ToolError(`"${slug}" can't be an item's name: use lowercase letters, numbers and hyphens.`);
-			const path = collection.settings.path === void 0 ? void 0 : entryAddress(collection.settings.path, slug);
+			const path = entryPathIn(siteSettings, collection.settings, slug, inLanguage ?? mainLanguage(siteSettings));
 			if (path && (isReservedPagePath(path) || (await takenAddresses(draft.store)).has(path))) throw new ToolError(`${path} is already taken on the site. Choose another name.`);
 		}
 		const known = new Set(collection.settings.fields.map((field) => field.name));
@@ -557,7 +600,7 @@ function registerTools(server, context) {
 		const change = entryFileChange({
 			id,
 			settings: collection.settings
-		}, slug, fields);
+		}, slug, fields, existing?.content ?? (inLanguage ? { inLanguage } : void 0));
 		const title = typeof fields.title === "string" ? fields.title : slug;
 		await save(draft, [change], `${existing ? "Update" : "Add"} ${collection.settings.entryName.toLowerCase()} "${title}"`);
 		return text({
@@ -614,29 +657,56 @@ function registerTools(server, context) {
 			saved: "changed"
 		});
 	});
-	tool("get_menus", "The site's menus, by name: each a list of links, which can have links of their own under them.", {
+	tool("get_menus", "The site's menus, by name: each a list of links, which can have links of their own under them. On a site in several languages, give a language's code for its menus; a language without menus of its own shows the main language's.", {
 		site: siteArg,
+		language: languageArg,
 		draft: draftArg
-	}, async ({ site: given, draft }) => {
-		return text(await readMenus(await reading(await open(given), draft)));
+	}, async ({ site: given, language, draft }) => {
+		const site = await open(given);
+		const { menus, languageMenus } = await readMenus(await reading(site, draft));
+		if (language === void 0 || language === mainLanguage(site.settings)) return text(menus);
+		const own = languageMenus[language];
+		return text(own ? own : {
+			sameAsMainLanguage: true,
+			menus
+		});
 	}, true);
 	tool("save_menu", "Replaces one of the site's menus, in a draft: a list of links, each with a label and an href.", {
 		site: siteArg,
 		menu: z.string().describe("The menu's name, such as main or footer."),
 		items: z.array(z.unknown()),
+		language: languageArg,
 		draft: draftArg
-	}, async ({ site: given, menu, items, draft: name }) => {
+	}, async ({ site: given, menu, items, language, draft: name }) => {
 		const draft = await changing(await open(given), name);
-		const menus = await readMenus(draft.store);
-		const result = menusFileSchema.safeParse({
+		const { menus, languageMenus } = await readMenus(draft.store);
+		const settings = await readSettings(draft.store);
+		const other = language !== void 0 && language !== mainLanguage(settings);
+		if (other && !isOtherLanguage(settings, language)) throw new ToolError(`${language} isn't one of the site's languages. get_site lists them.`);
+		const file = other ? {
+			version: 1,
+			menus,
+			languages: {
+				...languageMenus,
+				[language]: {
+					...languageMenus[language] ?? menus,
+					[menu]: items
+				}
+			}
+		} : {
 			version: 1,
 			menus: {
 				...menus,
 				[menu]: items
-			}
-		});
+			},
+			languages: languageMenus
+		};
+		const result = menusFileSchema.safeParse(file);
 		if (!result.success) throw new ToolError(`That menu doesn't fit: ${result.error.issues.map((issue) => `${issue.path.join(".")} ${issue.message}`).join("; ")}.`);
-		await save(draft, [menusFileChange(result.data.menus)], `Update menu "${menu}"`);
+		await save(draft, [menusFileChange({
+			menus: result.data.menus,
+			languageMenus: result.data.languages
+		})], `Update menu "${menu}"`);
 		return text({
 			draft: draft.name,
 			menu,
@@ -791,10 +861,10 @@ img[src$=".svg" i] { width: 100%; }
 */
 /** Splits a site's id into its host and repository, or `undefined` if it isn't one. */
 function parseSiteId(id) {
-	const match = /^(github|gitlab):([\w.-]+(?:\/[\w.-]+)+)$/.exec(id.trim());
+	const match = /^(github|gitlab|bitbucket):([\w.-]+(?:\/[\w.-]+)+)$/.exec(id.trim());
 	if (!match) return void 0;
 	const [, host, repo] = match;
-	if (host === "github" && repo?.split("/").length !== 2) return void 0;
+	if (host !== "gitlab" && repo?.split("/").length !== 2) return void 0;
 	return {
 		host,
 		repo: repo ?? ""

package/dist/{screenshots--uulXZYY.js → screenshots-yES3bUkH.js}

@@ -1,4 +1,4 @@
-import { COLLECTIONS_DIR, COLLECTION_SETTINGS_FILE, FOOTER_FILE, HEADER_FILE, MEDIA_DIR, MEDIA_FILE, MENUS_FILE, PAGES_DIR, SITE_FILE, collectionFileSchema, entryAddress, isAddressSegment, layoutFileSchema, mediaFileSchema, menusFileSchema, normalizePagePath, pageFileSchema, pageFileToPath, pagePathToFile, parseContentFile, parseEntryFile, readTextFiles, siteSettingsSchema } from "@goodfellow-cms/core";
+import { COLLECTIONS_DIR, COLLECTION_SETTINGS_FILE, FOOTER_FILE, HEADER_FILE, MEDIA_DIR, MEDIA_FILE, MENUS_FILE, PAGES_DIR, SITE_FILE, collectionFileSchema, entryPathIn, hasLanguages, isAddressSegment, layoutFileSchema, mainLanguage, mediaFileSchema, menusFileSchema, normalizePagePath, pageFileSchema, pageFileToPath, pagePathToFile, parseContentFile, parseEntryFile, readTextFiles, siteSettingsSchema } from "@goodfellow-cms/core";
 //#region src/content.ts
 /**
 * Reading a site's content a file at a time. Tools read only the files they
@@ -18,9 +18,18 @@ async function readSettings(source) {
 	const text = await source.read(SITE_FILE);
 	return text === void 0 ? siteSettingsSchema.parse({ version: 1 }) : parsed(parseContentFile("site", siteSettingsSchema, SITE_FILE, text));
 }
+/** The site's menus, and the ones of its other languages that have menus of their own. */
 async function readMenus(source) {
 	const text = await source.read(MENUS_FILE);
-	return text === void 0 ? {} : parsed(parseContentFile("menus", menusFileSchema, MENUS_FILE, text)).menus;
+	if (text === void 0) return {
+		menus: {},
+		languageMenus: {}
+	};
+	const file = parsed(parseContentFile("menus", menusFileSchema, MENUS_FILE, text));
+	return {
+		menus: file.menus,
+		languageMenus: file.languages ?? {}
+	};
 }
 async function readLayout(source, part) {
 	const file = part === "header" ? HEADER_FILE : FOOTER_FILE;
@@ -103,17 +112,46 @@ async function readEntry(source, collection, slug) {
 	};
 }
 /**
+* Each item's language, by its name. Only a site with other languages has
+* items in them, so only then are the items' files read, all in one go where
+* the source can.
+*/
+async function entryLanguages(source, collection, site) {
+	const main = mainLanguage(site);
+	if (!hasLanguages(site)) return new Map(collection.entries.map((entry) => [entry.slug, main]));
+	const texts = await readTextFiles(source, collection.entries.map((entry) => entry.file));
+	return new Map(collection.entries.map((entry) => {
+		const text = texts.get(entry.file);
+		const file = text === void 0 ? void 0 : parseEntryFile(collection.settings, entry.file, text);
+		return [entry.slug, file?.ok && file.value.inLanguage || main];
+	}));
+}
+/** Each item's address, by its name, in its language, where its collection gives items pages. */
+async function entryAddresses(source, collection, site) {
+	if (collection.settings.path === void 0) return /* @__PURE__ */ new Map();
+	const languages = await entryLanguages(source, collection, site);
+	return new Map(collection.entries.flatMap((entry) => {
+		const path = entryPathIn(site, collection.settings, entry.slug, languages.get(entry.slug) ?? mainLanguage(site));
+		return path === void 0 ? [] : [[entry.slug, path]];
+	}));
+}
+/**
 * Every address the site's pages and entries have, so a new page or entry
-* never takes one. Entries' addresses come from their collections' settings.
+* never takes one. Entries' addresses come from their collections' settings,
+* and in a site with other languages, their own languages.
 */
 async function takenAddresses(source) {
 	const addresses = new Set((await listPages(source)).map((page) => page.address));
+	const site = await readSettings(source);
 	for (const collection of await listCollections(source)) {
 		const text = await source.read(collection.file);
 		if (text === void 0) continue;
 		const settings = parseContentFile("collection", collectionFileSchema, collection.file, text);
 		if (!settings.ok || settings.value.path === void 0) continue;
-		for (const entry of collection.entries) addresses.add(entryAddress(settings.value.path, entry.slug));
+		for (const address of (await entryAddresses(source, {
+			...collection,
+			settings: settings.value
+		}, site)).values()) addresses.add(address);
 	}
 	return addresses;
 }
@@ -237,4 +275,4 @@ function localScreenshots(options = {}) {
 	} };
 }
 //#endregion
-export { listCollections as a, mediaImage as c, readEntry as d, readLayout as f, takenAddresses as g, readSettings as h, isMediaAddress as i, pageAddress as l, readPage as m, ToolError as n, listMedia as o, readMenus as p, contentFiles as r, listPages as s, localScreenshots as t, readCollection as u };
+export { readSettings as _, entryLanguages as a, listMedia as c, pageAddress as d, readCollection as f, readPage as g, readMenus as h, entryAddresses as i, listPages as l, readLayout as m, ToolError as n, isMediaAddress as o, readEntry as p, contentFiles as r, listCollections as s, localScreenshots as t, mediaImage as u, takenAddresses as v };

package/dist/screenshots.js

@@ -1,2 +1,2 @@
-import { t as localScreenshots } from "./screenshots--uulXZYY.js";
+import { t as localScreenshots } from "./screenshots-yES3bUkH.js";
 export { localScreenshots };

package/dist/stdio.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
-import { a as listCollections, c as mediaImage, d as readEntry, f as readLayout, g as takenAddresses, h as readSettings, i as isMediaAddress, l as pageAddress, m as readPage, n as ToolError, o as listMedia, p as readMenus, r as contentFiles, s as listPages, t as localScreenshots, u as readCollection } from "./screenshots--uulXZYY.js";
+import { _ as readSettings, a as entryLanguages, c as listMedia, d as pageAddress, f as readCollection, g as readPage, h as readMenus, i as entryAddresses, l as listPages, m as readLayout, n as ToolError, o as isMediaAddress, p as readEntry, r as contentFiles, s as listCollections, t as localScreenshots, u as mediaImage, v as takenAddresses } from "./screenshots-yES3bUkH.js";
+import { bitbucket } from "@goodfellow-cms/bitbucket";
 import { github } from "@goodfellow-cms/github";
 import { gitlab } from "@goodfellow-cms/gitlab";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ConflictError, DraftError, FOOTER_FILE, GOODFELLOW_VERSION, HEADER_FILE, SITE_DESCRIPTION_PATH, SignInError, entryAddress, entryFieldProblems, entryFileChange, isAddressSegment, isEmptyValue, isReservedPagePath, layoutFileChange, menusFileChange, menusFileSchema, newDraftName, pageFileChange, pageFileToPath, parseSiteDescription, siteSettingsFileChange, siteSettingsSchema, siteVersionProblem, writeChanges } from "@goodfellow-cms/core";
+import { ConflictError, DraftError, FOOTER_FILE, GOODFELLOW_VERSION, HEADER_FILE, SITE_DESCRIPTION_PATH, SignInError, describedConfig, entryFieldProblems, entryFileChange, entryPathIn, hasLanguages, isAddressSegment, isEmptyValue, isOtherLanguage, isReservedPagePath, layoutFileChange, mainLanguage, menusFileChange, menusFileSchema, newDraftName, pageFileChange, pageFileToPath, parseSiteDescription, siteLanguages, siteSettingsFileChange, siteSettingsSchema, siteVersionProblem, writeChanges } from "@goodfellow-cms/core";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { cleanProps, objectSchema, slotNames, toContent, toFlatBlocks } from "@goodfellow-cms/ai/schema";
 import { z } from "zod";
@@ -13,17 +14,6 @@ import { z } from "zod";
 * description its build published (`goodfellow-site.json`), which says what
 * blocks it has, since the connector doesn't have the site's code.
 */
-function configFrom(description, templates) {
-	return {
-		components: Object.fromEntries(Object.entries(description.blocks).filter(([, block]) => templates || !block.templateOnly).map(([name, block]) => [name, {
-			...block.label && { label: block.label },
-			fields: block.fields,
-			...block.defaultProps && { defaultProps: block.defaultProps },
-			render: () => null
-		}])),
-		root: { fields: description.root.fields }
-	};
-}
 const VERSION_PROBLEMS = {
 	"site-too-old": (site) => `The site was built with Goodfellow ${site}, which is too old for Claude to change it. Ask the site's owner to update it on the admin panel's Updates screen; reading it still works.`,
 	"tool-too-old": (site) => `The site was built with Goodfellow ${site}, which is newer than this connector (${GOODFELLOW_VERSION}). Update the connector to change it; reading it still works.`
@@ -45,8 +35,8 @@ async function openSite(context, id) {
 		settings,
 		url,
 		description,
-		pageConfig: configFrom(description, false),
-		templateConfig: configFrom(description, true),
+		pageConfig: describedConfig(description, "page"),
+		templateConfig: describedConfig(description, "template"),
 		...problem && { versionProblem: VERSION_PROBLEMS[problem](description.goodfellow) }
 	};
 }
@@ -71,6 +61,7 @@ const INSTRUCTIONS = `These tools edit websites built with Goodfellow, for peopl
 /** Why `publish` refuses, on sites whose config says `claude: { publish: false }`. */
 const NO_PUBLISHING = "The site's owner has turned off publishing from Claude. Submit the draft for review instead (submit_for_review), and someone who looks after the site publishes it.";
 const siteArg = z.string().optional().describe("Which site, from list_sites. Leave it out when there's only one.");
+const languageArg = z.string().optional().describe("On a site in several languages, the code of a language from get_site. Leave it out for the main language.");
 const draftArg = z.string().optional().describe("The draft, as an earlier change returned it. To read: leave it out for the live site. To change: leave it out to start a new draft.");
 const flatBlock = z.object({
 	type: z.string().describe("The block's name, from get_blocks."),
@@ -205,7 +196,12 @@ function registerTools(server, context) {
 				id: collection.id,
 				entries: collection.entries.length
 			})),
-			menus: Object.keys(menus),
+			menus: Object.keys(menus.menus),
+			...hasLanguages(site.settings) && { languages: siteLanguages(site.settings).map((language) => ({
+				code: language.code,
+				name: language.name,
+				...language.main ? { main: true } : { pagesUnder: language.prefix }
+			})) },
 			blocks: Object.entries(site.description.blocks).map(([name, block]) => ({
 				name,
 				...block.label && { label: block.label },
@@ -281,7 +277,7 @@ function registerTools(server, context) {
 			content: built.content
 		};
 		const title = typeof props.title === "string" && props.title ? props.title : path;
-		await save(draft, [pageFileChange(path, data)], `${existing ? "Update" : "Add"} page "${title}"`);
+		await save(draft, [pageFileChange(path, data, existing?.content)], `${existing ? "Update" : "Add"} page "${title}"`);
 		return text({
 			draft: draft.name,
 			address: path,
@@ -348,9 +344,12 @@ function registerTools(server, context) {
 		collection: z.string().describe("The collection's id, from get_site."),
 		draft: draftArg
 	}, async ({ site: given, collection: id, draft }) => {
-		const site = await open(given);
-		const collection = await readCollection(await reading(site, draft), id);
+		const source = await reading(await open(given), draft);
+		const collection = await readCollection(source, id);
 		const { settings } = collection;
+		const siteSettings = await readSettings(source);
+		const [languages, addresses] = await Promise.all([entryLanguages(source, collection, siteSettings), entryAddresses(source, collection, siteSettings)]);
+		const several = hasLanguages(siteSettings);
 		return text({
 			id,
 			name: settings.name,
@@ -360,7 +359,8 @@ function registerTools(server, context) {
 			fields: settings.fields,
 			items: collection.entries.map((entry) => ({
 				slug: entry.slug,
-				...settings.path !== void 0 && { address: entryAddress(settings.path, entry.slug) }
+				...addresses.has(entry.slug) && { address: addresses.get(entry.slug) },
+				...several && { language: languages.get(entry.slug) }
 			}))
 		});
 	}, true);
@@ -385,14 +385,19 @@ function registerTools(server, context) {
 		collection: z.string(),
 		slug: z.string().describe("The item's name in its address and file: lowercase letters, numbers and hyphens, such as open-day."),
 		values: z.record(z.string(), z.unknown()).describe("Field values, by the fields' names from get_collection."),
+		language: z.string().optional().describe("For a new item on a site in several languages, the code of the language it's in, from get_site. Leave it out for the site's main language. Names are the collection's whatever an item's language, so a translation has a name of its own."),
 		draft: draftArg
-	}, async ({ site: given, collection: id, slug, values, draft: name }) => {
+	}, async ({ site: given, collection: id, slug, values, language, draft: name }) => {
 		const draft = await changing(await open(given), name);
 		const collection = await readCollection(draft.store, id);
 		const existing = await readEntry(draft.store, collection, slug);
+		const siteSettings = await readSettings(draft.store);
+		if (language !== void 0 && existing && language !== (existing.content.inLanguage ?? mainLanguage(siteSettings))) throw new ToolError(`An item's language can't change. Save the translation as an item of its own.`);
+		if (language !== void 0 && language !== mainLanguage(siteSettings) && !isOtherLanguage(siteSettings, language)) throw new ToolError(`${language} isn't one of the site's languages. get_site lists them.`);
+		const inLanguage = language !== void 0 && language !== mainLanguage(siteSettings) ? language : void 0;
 		if (!existing) {
 			if (!isAddressSegment(slug)) throw new ToolError(`"${slug}" can't be an item's name: use lowercase letters, numbers and hyphens.`);
-			const path = collection.settings.path === void 0 ? void 0 : entryAddress(collection.settings.path, slug);
+			const path = entryPathIn(siteSettings, collection.settings, slug, inLanguage ?? mainLanguage(siteSettings));
 			if (path && (isReservedPagePath(path) || (await takenAddresses(draft.store)).has(path))) throw new ToolError(`${path} is already taken on the site. Choose another name.`);
 		}
 		const known = new Set(collection.settings.fields.map((field) => field.name));
@@ -409,7 +414,7 @@ function registerTools(server, context) {
 		const change = entryFileChange({
 			id,
 			settings: collection.settings
-		}, slug, fields);
+		}, slug, fields, existing?.content ?? (inLanguage ? { inLanguage } : void 0));
 		const title = typeof fields.title === "string" ? fields.title : slug;
 		await save(draft, [change], `${existing ? "Update" : "Add"} ${collection.settings.entryName.toLowerCase()} "${title}"`);
 		return text({
@@ -467,30 +472,56 @@ function registerTools(server, context) {
 			saved: "changed"
 		});
 	});
-	tool("get_menus", "The site's menus, by name: each a list of links, which can have links of their own under them.", {
+	tool("get_menus", "The site's menus, by name: each a list of links, which can have links of their own under them. On a site in several languages, give a language's code for its menus; a language without menus of its own shows the main language's.", {
 		site: siteArg,
+		language: languageArg,
 		draft: draftArg
-	}, async ({ site: given, draft }) => {
+	}, async ({ site: given, language, draft }) => {
 		const site = await open(given);
-		return text(await readMenus(await reading(site, draft)));
+		const { menus, languageMenus } = await readMenus(await reading(site, draft));
+		if (language === void 0 || language === mainLanguage(site.settings)) return text(menus);
+		const own = languageMenus[language];
+		return text(own ? own : {
+			sameAsMainLanguage: true,
+			menus
+		});
 	}, true);
 	tool("save_menu", "Replaces one of the site's menus, in a draft: a list of links, each with a label and an href.", {
 		site: siteArg,
 		menu: z.string().describe("The menu's name, such as main or footer."),
 		items: z.array(z.unknown()),
+		language: languageArg,
 		draft: draftArg
-	}, async ({ site: given, menu, items, draft: name }) => {
+	}, async ({ site: given, menu, items, language, draft: name }) => {
 		const draft = await changing(await open(given), name);
-		const menus = await readMenus(draft.store);
-		const result = menusFileSchema.safeParse({
+		const { menus, languageMenus } = await readMenus(draft.store);
+		const settings = await readSettings(draft.store);
+		const other = language !== void 0 && language !== mainLanguage(settings);
+		if (other && !isOtherLanguage(settings, language)) throw new ToolError(`${language} isn't one of the site's languages. get_site lists them.`);
+		const file = other ? {
+			version: 1,
+			menus,
+			languages: {
+				...languageMenus,
+				[language]: {
+					...languageMenus[language] ?? menus,
+					[menu]: items
+				}
+			}
+		} : {
 			version: 1,
 			menus: {
 				...menus,
 				[menu]: items
-			}
-		});
+			},
+			languages: languageMenus
+		};
+		const result = menusFileSchema.safeParse(file);
 		if (!result.success) throw new ToolError(`That menu doesn't fit: ${result.error.issues.map((issue) => `${issue.path.join(".")} ${issue.message}`).join("; ")}.`);
-		await save(draft, [menusFileChange(result.data.menus)], `Update menu "${menu}"`);
+		await save(draft, [menusFileChange({
+			menus: result.data.menus,
+			languageMenus: result.data.languages
+		})], `Update menu "${menu}"`);
 		return text({
 			draft: draft.name,
 			menu,
@@ -621,10 +652,10 @@ function registerTools(server, context) {
 */
 /** Splits a site's id into its host and repository, or `undefined` if it isn't one. */
 function parseSiteId(id) {
-	const match = /^(github|gitlab):([\w.-]+(?:\/[\w.-]+)+)$/.exec(id.trim());
+	const match = /^(github|gitlab|bitbucket):([\w.-]+(?:\/[\w.-]+)+)$/.exec(id.trim());
 	if (!match) return void 0;
 	const [, host, repo] = match;
-	if (host === "github" && repo?.split("/").length !== 2) return void 0;
+	if (host !== "gitlab" && repo?.split("/").length !== 2) return void 0;
 	return {
 		host,
 		repo: repo ?? ""
@@ -656,10 +687,10 @@ function fail(message) {
 }
 const siteId = process.env.GOODFELLOW_SITE?.trim() || process.argv[2];
 const token = process.env.GOODFELLOW_TOKEN?.trim();
-if (!siteId) fail("Set GOODFELLOW_SITE to the site's repository, such as github:owner/site or gitlab:group/site.");
+if (!siteId) fail("Set GOODFELLOW_SITE to the site's repository, such as github:owner/site, gitlab:group/site or bitbucket:workspace/site.");
 const site = parseSiteId(siteId);
-if (!site) fail(`${siteId} isn't a site. Write it as github:owner/site or gitlab:group/site.`);
-if (!token) fail("Set GOODFELLOW_TOKEN to a GitHub or GitLab token that can edit the site.");
+if (!site) fail(`${siteId} isn't a site. Write it as github:owner/site, gitlab:group/site or bitbucket:workspace/site.`);
+if (!token) fail("Set GOODFELLOW_TOKEN to a GitHub, GitLab or Bitbucket token that can edit the site.");
 const storage = {
 	local: memoryStorage(),
 	session: memoryStorage()
@@ -668,6 +699,9 @@ const host = site.host === "github" ? github({
 	repo: site.repo,
 	signIn: false,
 	storage
+}) : site.host === "bitbucket" ? bitbucket({
+	repo: site.repo,
+	storage
 }) : gitlab({
 	project: site.repo,
 	...process.env.GITLAB_URL && { url: process.env.GITLAB_URL },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfellow-cms/mcp",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Work on a Goodfellow site from Claude: read and change its pages, entries and settings, see them in screenshots, and publish them or submit them for review.",
   "keywords": [
     "goodfellow",
@@ -37,25 +37,26 @@
     "dist"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.31.0",
-    "zod": "4.6.5",
-    "@goodfellow-cms/ai": "0.4.0",
-    "@goodfellow-cms/core": "0.4.0",
-    "@goodfellow-cms/github": "0.4.0",
-    "@goodfellow-cms/gitlab": "0.4.0"
+    "@goodfellow-cms/ai": "0.6.0",
+    "@goodfellow-cms/core": "0.6.0",
+    "@goodfellow-cms/bitbucket": "0.6.0",
+    "@goodfellow-cms/github": "0.6.0",
+    "@goodfellow-cms/gitlab": "0.6.0",
+    "@modelcontextprotocol/sdk": "1.32.1",
+    "zod": "4.6.6"
   },
   "optionalDependencies": {
     "playwright-core": "1.63.0"
   },
   "devDependencies": {
+    "@goodfellow-cms/blocks": "0.6.0",
+    "@goodfellow-cms/react": "0.6.0",
     "@puckeditor/core": "0.23.0",
     "@types/node": "^22.19.0",
-    "fflate": "0.8.3",
-    "@goodfellow-cms/blocks": "0.4.0",
-    "@goodfellow-cms/react": "0.4.0"
+    "fflate": "0.8.3"
   },
   "engines": {
-    "node": ">=22"
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
   },
   "publishConfig": {
     "access": "public"