@lupinum/ginko-docs 0.4.0-rc.1 → 0.4.0-rc.2

package/README.md

@@ -29,7 +29,7 @@ Use this package when a Nuxt application needs documentation routes, navigation,
 ## Installation
 
 ```bash
-pnpm add -D @lupinum/ginko-docs@0.4.0-rc.1 @lupinum/ginko-content@1.0.0-beta.4
+pnpm add -D @lupinum/ginko-docs@0.4.0-rc.2 @lupinum/ginko-content@1.0.0-beta.5
 ```
 
 ```ts

package/app/app.vue

@@ -18,6 +18,7 @@ const siteUrl = docsConfig.site.url;
 
 useSeoMeta({
   ogSiteName: computed(() => getLocalizedSiteText(docsConfig.site.name, locale.value)),
+  ogType: "website",
   ogUrl: canonicalUrl,
   twitterCard: "summary_large_image",
 });
@@ -35,6 +36,15 @@ useSchemaJsonLd(() => [
     url: siteUrl,
     inLanguage: locale.value,
   },
+  {
+    "@type": "SoftwareApplication",
+    name: getLocalizedSiteText(docsConfig.site.name, locale.value),
+    description: getLocalizedSiteText(docsConfig.site.description, locale.value),
+    url: siteUrl,
+    applicationCategory: "DeveloperApplication",
+    operatingSystem: "Web",
+    ...(docsConfig.social?.github ? { sameAs: [docsConfig.social.github] } : {}),
+  },
 ]);
 
 useHead(() => ({

package/nuxt.config.ts

@@ -10,6 +10,7 @@ import { i18nPages } from "./i18n/routes";
 import { defaultLocale, localeCodes, locales, localizedPath } from "./i18n/locales";
 import { routeSlugs } from "./shared/route-slugs";
 import { layerIconCollections, layerIconNames } from "./icon-bundle";
+import packageMetadata from "./package.json" with { type: "json" };
 
 const root = dirname(fileURLToPath(import.meta.url));
 const app = join(root, "app");
@@ -56,7 +57,7 @@ export default defineNuxtConfig({
   },
   mcp: {
     name: "Ginko Docs",
-    version: "0.4.0-rc.1",
+    version: packageMetadata.version,
   },
   components: {
     dirs: [
@@ -163,7 +164,7 @@ export default defineNuxtConfig({
     },
     search: { engine: "minisearch" },
     sitemap: true,
-    agent: { routes: true, linkHeaders: true, markdownNegotiation: true, prerender: true },
+    agent: { routes: true, linkHeaders: true, delivery: "static" },
   },
   sitemap: {
     excludeAppSources: ["nuxt:prerender"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-docs",
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0-rc.2",
   "description": "A Nuxt documentation layer powered by Ginko Content.",
   "keywords": [
     "content",
@@ -86,7 +86,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@lupinum/ginko-content": ">=1.0.0-beta.4 <2.0.0",
+    "@lupinum/ginko-content": ">=1.0.0-beta.5 <2.0.0",
     "nuxt": ">=4.5.1 <5",
     "vue": "^3.5.35",
     "vue-router": "^5.1.0"

package/server/routes/.well-known/ai-catalog.json.get.ts

@@ -0,0 +1,13 @@
+import { setResponseHeaders } from "h3";
+import { useAppConfig } from "#imports";
+import { createGinkoDocsAiCatalog } from "../../utils/mcp-server-card";
+
+export default defineEventHandler((event) => {
+  setResponseHeaders(event, {
+    "access-control-allow-origin": "*",
+    "cache-control": "public, max-age=3600",
+    "content-type": "application/ai-catalog+json; charset=utf-8",
+  });
+
+  return createGinkoDocsAiCatalog(useAppConfig().ginkoDocs.site.url);
+});

package/server/routes/mcp/server-card.get.ts

@@ -0,0 +1,17 @@
+import { setResponseHeaders } from "h3";
+import { useAppConfig } from "#imports";
+import packageMetadata from "../../../package.json" with { type: "json" };
+import { createGinkoDocsServerCard } from "../../utils/mcp-server-card";
+
+export default defineEventHandler((event) => {
+  setResponseHeaders(event, {
+    "access-control-allow-origin": "*",
+    "cache-control": "public, max-age=3600",
+    "content-type": "application/mcp-server-card+json; charset=utf-8",
+  });
+
+  return createGinkoDocsServerCard({
+    origin: useAppConfig().ginkoDocs.site.url,
+    version: packageMetadata.version,
+  });
+});

package/server/utils/mcp-server-card.ts

@@ -0,0 +1,45 @@
+export interface GinkoDocsServerCardOptions {
+  origin: string;
+  version: string;
+}
+
+export function createGinkoDocsServerCard({ origin, version }: GinkoDocsServerCardOptions) {
+  const baseUrl = new URL(origin);
+
+  return {
+    $schema: "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
+    name: "dev.lupinum/ginko-docs",
+    title: "Ginko Docs",
+    version,
+    description: "Read published Ginko Docs pages through its public MCP tools.",
+    websiteUrl: new URL("/docs/features/agent-readable-output", baseUrl).toString(),
+    repository: {
+      source: "github",
+      url: "https://github.com/lupinum-dev/ginko-docs",
+    },
+    remotes: [
+      {
+        type: "streamable-http",
+        url: new URL("/mcp", baseUrl).toString(),
+        supportedProtocolVersions: ["2025-11-25"],
+      },
+    ],
+  } as const;
+}
+
+export function createGinkoDocsAiCatalog(origin: string) {
+  const baseUrl = new URL(origin);
+
+  return {
+    specVersion: "1.0",
+    entries: [
+      {
+        identifier: "urn:air:ginko-docs.lupinum.com:mcp:ginko-docs",
+        displayName: "Ginko Docs MCP Server",
+        type: "application/mcp-server-card+json",
+        description: "Read the public Ginko Docs documentation through MCP.",
+        url: new URL("/mcp/server-card", baseUrl).toString(),
+      },
+    ],
+  } as const;
+}