@sync.so/mcp-server 0.1.0

package/dist/tools/generator.test.js

@@ -0,0 +1,178 @@
+import { describe, expect, it, vi } from 'vitest';
+import { generateTools, operationIdToToolName } from './generator.js';
+describe('operationIdToToolName', () => {
+    it('converts controller operation IDs to tool names', () => {
+        expect(operationIdToToolName('GenerateController_createGeneration')).toBe('generate_create-generation');
+        expect(operationIdToToolName('AssetsController_getAll')).toBe('assets_get-all');
+        expect(operationIdToToolName('ModelsController_getPublic')).toBe('models_get-public');
+    });
+    it('kebab-cases multi-word controller names', () => {
+        expect(operationIdToToolName('DeviceAuthController_start')).toBe('device-auth_start');
+        expect(operationIdToToolName('AssetMetadataController_getAll')).toBe('asset-metadata_get-all');
+    });
+    it('handles single-part operation IDs', () => {
+        expect(operationIdToToolName('createSomething')).toBe('create-something');
+    });
+});
+describe('generateTools', () => {
+    const mockHttpClient = {
+        request: vi.fn().mockResolvedValue({ id: 'gen-123' }),
+    };
+    const operations = [
+        {
+            operationId: 'GenerateController_createGeneration',
+            method: 'post',
+            path: '/v2/generate',
+            summary: 'Create a generation',
+            tags: ['Generate'],
+            parameters: [],
+            requestBody: {
+                schema: {
+                    type: 'object',
+                    properties: {
+                        model: { type: 'string' },
+                    },
+                    required: ['model'],
+                },
+                contentType: 'application/json',
+            },
+            isMultipart: false,
+        },
+        {
+            operationId: 'GenerateController_getGeneration',
+            method: 'get',
+            path: '/v2/generate/{id}',
+            summary: 'Get a generation by ID',
+            tags: ['Generate'],
+            parameters: [
+                {
+                    name: 'id',
+                    in: 'path',
+                    required: true,
+                    schema: { type: 'string' },
+                },
+            ],
+            isMultipart: false,
+        },
+    ];
+    it('generates tools from operations', () => {
+        const tools = generateTools(operations, mockHttpClient);
+        expect(tools).toHaveLength(2);
+        expect(tools[0]?.name).toBe('generate_create-generation');
+        expect(tools[1]?.name).toBe('generate_get-generation');
+    });
+    it('uses overrides for known tools', () => {
+        const tools = generateTools(operations, mockHttpClient);
+        expect(tools[0]?.description).toContain('lipsync video');
+    });
+    it('handler calls httpClient with correct params', async () => {
+        const tools = generateTools(operations, mockHttpClient);
+        await tools[0]?.handler({ model: 'sync-1.9.0-beta' });
+        expect(mockHttpClient.request).toHaveBeenCalledWith('post', '/v2/generate', {
+            query: undefined,
+            body: { model: 'sync-1.9.0-beta' },
+        });
+    });
+    it('handler substitutes path parameters', async () => {
+        const tools = generateTools(operations, mockHttpClient);
+        await tools[1]?.handler({ id: 'gen-456' });
+        expect(mockHttpClient.request).toHaveBeenCalledWith('get', '/v2/generate/gen-456', {
+            query: undefined,
+            body: undefined,
+        });
+    });
+    it('handler builds query parameters', async () => {
+        const opWithQuery = [
+            {
+                operationId: 'AssetsController_getAll',
+                method: 'get',
+                path: '/v2/assets',
+                summary: 'List assets',
+                tags: ['Assets'],
+                parameters: [
+                    {
+                        name: 'limit',
+                        in: 'query',
+                        required: false,
+                        schema: { type: 'number' },
+                    },
+                ],
+                isMultipart: false,
+            },
+        ];
+        const tools = generateTools(opWithQuery, mockHttpClient);
+        await tools[0]?.handler({ limit: 10 });
+        expect(mockHttpClient.request).toHaveBeenCalledWith('get', '/v2/assets', {
+            query: { limit: '10' },
+            body: undefined,
+        });
+    });
+    it('handles allOf composed body schemas', async () => {
+        const opWithAllOf = [
+            {
+                operationId: 'TestController_create',
+                method: 'post',
+                path: '/v2/test',
+                summary: 'Test allOf',
+                tags: ['Test'],
+                parameters: [],
+                requestBody: {
+                    schema: {
+                        allOf: [
+                            {
+                                type: 'object',
+                                properties: { name: { type: 'string' } },
+                                required: ['name'],
+                            },
+                            {
+                                type: 'object',
+                                properties: { age: { type: 'number' } },
+                            },
+                        ],
+                    },
+                    contentType: 'application/json',
+                },
+                isMultipart: false,
+            },
+        ];
+        const tools = generateTools(opWithAllOf, mockHttpClient);
+        await tools[0]?.handler({ name: 'test', age: 25 });
+        expect(mockHttpClient.request).toHaveBeenCalledWith('post', '/v2/test', {
+            query: undefined,
+            body: { name: 'test', age: 25 },
+        });
+    });
+    it('handles schema with both properties and allOf', async () => {
+        const opWithBoth = [
+            {
+                operationId: 'TestController_mixed',
+                method: 'post',
+                path: '/v2/mixed',
+                summary: 'Test mixed',
+                tags: ['Test'],
+                parameters: [],
+                requestBody: {
+                    schema: {
+                        type: 'object',
+                        properties: { base: { type: 'string' } },
+                        required: ['base'],
+                        allOf: [
+                            {
+                                type: 'object',
+                                properties: { extra: { type: 'number' } },
+                            },
+                        ],
+                    },
+                    contentType: 'application/json',
+                },
+                isMultipart: false,
+            },
+        ];
+        const tools = generateTools(opWithBoth, mockHttpClient);
+        await tools[0]?.handler({ base: 'hello', extra: 42 });
+        expect(mockHttpClient.request).toHaveBeenCalledWith('post', '/v2/mixed', {
+            query: undefined,
+            body: { base: 'hello', extra: 42 },
+        });
+    });
+});

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export type { McpToolDefinition } from './generator.js';
+export { generateTools, operationIdToToolName } from './generator.js';
+export { getOverride } from './overrides.js';
+export type { ToolRegistry } from './registry.js';
+export { createToolRegistry } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { generateTools, operationIdToToolName } from './generator.js';
+export { getOverride } from './overrides.js';
+export { createToolRegistry } from './registry.js';

package/dist/tools/overrides.d.ts

@@ -0,0 +1,6 @@
+type ToolOverride = {
+    description: string;
+};
+export declare function getOverride(toolName: string): ToolOverride | undefined;
+export {};
+//# sourceMappingURL=overrides.d.ts.map

package/dist/tools/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/tools/overrides.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAgCF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE"}

package/dist/tools/overrides.js

@@ -0,0 +1,29 @@
+const TOOL_OVERRIDES = {
+    'generate_create-generation': {
+        description: 'Create a lipsync video. Provide video + audio inputs (URLs or asset IDs). Returns a generation ID — poll with get-generation until status is COMPLETED.',
+    },
+    'generate_get-generation': {
+        description: 'Get generation status/result by ID. Poll until status is COMPLETED. Result includes output video URL.',
+    },
+    'generations_get-generations': {
+        description: 'List generations for the current organization. Supports pagination.',
+    },
+    generations_estimate: {
+        description: 'Estimate the cost of a generation before creating it. Returns estimated credits.',
+    },
+    'assets_get-all': {
+        description: 'List all assets (videos, audio files) in the current organization.',
+    },
+    assets_get: {
+        description: 'Get a specific asset by ID. Returns asset details and URL.',
+    },
+    'models_get-public': {
+        description: 'List all available lipsync models. Use this to discover model IDs for generation.',
+    },
+    'generate_get-generations': {
+        description: 'List recent generations. Use to find generation IDs or check batch status.',
+    },
+};
+export function getOverride(toolName) {
+    return TOOL_OVERRIDES[toolName];
+}

package/dist/tools/registry.d.ts

@@ -0,0 +1,8 @@
+import type { McpToolDefinition } from './generator.js';
+export type ToolRegistry = {
+    list: () => McpToolDefinition[];
+    get: (name: string) => McpToolDefinition | undefined;
+    search: (query: string) => McpToolDefinition[];
+};
+export declare function createToolRegistry(tools: McpToolDefinition[]): ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,iBAAiB,EAAE,CAAC;IAChC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IACrD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,YAAY,CAsB3E"}

package/dist/tools/registry.js

@@ -0,0 +1,18 @@
+export function createToolRegistry(tools) {
+    const toolMap = new Map();
+    for (const tool of tools) {
+        toolMap.set(tool.name, tool);
+    }
+    return {
+        list() {
+            return [...toolMap.values()];
+        },
+        get(name) {
+            return toolMap.get(name);
+        },
+        search(query) {
+            const lower = query.toLowerCase();
+            return [...toolMap.values()].filter((t) => t.name.toLowerCase().includes(lower) || t.description.toLowerCase().includes(lower));
+        },
+    };
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@sync.so/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for the Sync API — give AI agents the ability to create lipsync videos, manage assets, and more",
+  "keywords": ["mcp", "sync", "lipsync", "ai", "video", "model-context-protocol"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/synchronicity-labs/mcp-server.git"
+  },
+  "homepage": "https://sync.so/docs",
+  "bugs": {
+    "url": "https://github.com/synchronicity-labs/mcp-server/issues"
+  },
+  "type": "module",
+  "bin": {
+    "sync-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist .cache",
+    "dev": "tsc -b --watch",
+    "lint": "biome check ./src",
+    "lint:fix": "biome check --fix ./src",
+    "format": "biome format --write ./src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit --emitDeclarationOnly false",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.7",
+    "@types/node": "^22.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.12"
+  }
+}