Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
Improve MCP structured result visibility (#167)
Ben Senescuf58efea16437
diff --git a/src/server/mcp/formatters.test.ts b/src/server/mcp/formatters.test.tsindex 2c206807..9aae6b0b 100644--- a/src/server/mcp/formatters.test.ts+++ b/src/server/mcp/formatters.test.ts@@ -44,4 +44,41 @@ describe("mcpResponse", () => {});expect(result.structuredContent).toEqual({ foo: "bar" });});++ it("mirrors metadata into structuredContent for clients that hide _meta", () => {+ const result = mcpResponse({+ text: "hi",+ meta: {+ url: "https://app.openseo.so/p/1",+ projectId: "1",+ creditsRemaining: 100,+ },+ structuredContent: { foo: "bar" },+ });++ expect(result.structuredContent).toEqual({+ foo: "bar",+ meta: {+ url: "https://app.openseo.so/p/1",+ projectId: "1",+ creditsRemaining: 100,+ },+ });+ expect(result._meta).toEqual({+ url: "https://app.openseo.so/p/1",+ projectId: "1",+ creditsRemaining: 100,+ });+ });++ it("uses metadata as structuredContent when no data payload is provided", () => {+ const result = mcpResponse({+ text: "hi",+ meta: { url: "https://app.openseo.so" },+ });++ expect(result.structuredContent).toEqual({+ meta: { url: "https://app.openseo.so" },+ });+ });});diff --git a/src/server/mcp/formatters.ts b/src/server/mcp/formatters.tsindex 4039228c..f5a7762e 100644--- a/src/server/mcp/formatters.ts+++ b/src/server/mcp/formatters.ts@@ -17,15 +17,22 @@ export function mcpResponse(opts: {const result: CallToolResult = {content: [{ type: "text", text: opts.text }],};- if (opts.structuredContent) {- result.structuredContent = opts.structuredContent;- }+ let meta: Record<string, unknown> | undefined;if (opts.meta) {- // Drop undefined keys so the wire payload stays clean.- const meta: Record<string, unknown> = {};+ meta = {};for (const [key, value] of Object.entries(opts.meta)) {if (value !== undefined) meta[key] = value;}+ }+ if (opts.structuredContent) {+ result.structuredContent =+ meta && Object.keys(meta).length > 0+ ? { ...opts.structuredContent, meta }+ : opts.structuredContent;+ } else if (meta && Object.keys(meta).length > 0) {+ result.structuredContent = { meta };+ }+ if (meta) {if (Object.keys(meta).length > 0) {result._meta = meta;}diff --git a/src/server/mcp/tools/save-keywords.ts b/src/server/mcp/tools/save-keywords.tsindex ff2e2d48..a796921e 100644--- a/src/server/mcp/tools/save-keywords.ts+++ b/src/server/mcp/tools/save-keywords.ts@@ -46,6 +46,13 @@ export const saveKeywordsTool = {args.projectId,`/p/${args.projectId}/saved`,),+ structuredContent: {+ projectId: args.projectId,+ savedCount: args.keywords.length,+ keywords: args.keywords,+ locationCode: args.locationCode ?? DEFAULT_LOCATION_CODE,+ languageCode: args.languageCode ?? DEFAULT_LANGUAGE_CODE,+ },});}),};