Merge pull request #187 from supabase-community/feat/minified-graphql-schema

feat: minifiy content api graphql schema

Author: gregnr

packages/mcp-server-supabase/package.json

@@ -50,6 +50,7 @@
     "@modelcontextprotocol/sdk": "^1.18.0",
     "@supabase/mcp-utils": "workspace:^",
     "common-tags": "^1.8.2",
+    "gqlmin": "^0.3.1",
     "graphql": "^16.11.0",
     "openapi-fetch": "^0.13.5",
     "zod": "^3.24.1"

packages/mcp-server-supabase/src/content-api/index.ts

@@ -1,3 +1,4 @@
+import gqlmin from 'gqlmin';
 import { z } from 'zod';
 import { GraphQLClient, type GraphQLRequest, type QueryFn } from './graphql.js';
 
@@ -25,7 +26,8 @@ export async function createContentApiClient(
     loadSchema: async () => {
       const response = await graphqlClient.query({ query: '{ schema }' });
       const { schema } = contentApiSchemaResponseSchema.parse(response);
-      return schema;
+      const minifiedSchema = gqlmin(schema);
+      return minifiedSchema;
     },
     async query(request: GraphQLRequest) {
       return graphqlClient.query(request);

packages/mcp-server-supabase/src/server.test.ts

@@ -5,6 +5,7 @@ import {
 } from '@modelcontextprotocol/sdk/types.js';
 import { StreamTransport } from '@supabase/mcp-utils';
 import { codeBlock, stripIndent } from 'common-tags';
+import gqlmin from 'gqlmin';
 import { setupServer } from 'msw/node';
 import { beforeEach, describe, expect, test } from 'vitest';
 import {
@@ -2962,7 +2963,8 @@ describe('docs tools', () => {
       throw new Error('tool description not found');
     }
 
-    expect(tool.description.includes(contentApiMockSchema)).toBe(true);
+    const minifiedSchema = gqlmin(contentApiMockSchema);
+    expect(tool.description.includes(minifiedSchema)).toBe(true);
   });
 
   test('schema is only loaded when listing tools', async () => {

packages/mcp-server-supabase/src/tools/docs-tools.ts

@@ -16,7 +16,9 @@ export function getDocsTools({ contentApiClient }: DocsToolsOptions) {
         return source`
           Search the Supabase documentation using GraphQL. Must be a valid GraphQL query.
           You should default to calling this even if you think you already know the answer, since the documentation is always being updated.
-          Below is the GraphQL schema for the Supabase docs endpoint:
+
+          Below is the GraphQL schema for this tool:
+
           ${schema}
         `;
       },