Spline MCP Server

Implementation Reference

• src/tools/object-tools.js:16-38 (handler)

  The handler function for the 'getObjects' tool. It takes a sceneId, fetches objects using apiClient.getObjects, and returns a formatted MCP response with JSON stringified objects or an error.

  async ({ sceneId }) => {
    try {
      const objects = await apiClient.getObjects(sceneId);
      return {
        content: [
          { 
            type: 'text', 
            text: JSON.stringify(objects, null, 2) 
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          { 
            type: 'text', 
            text: `Error retrieving objects: ${error.message}` 
          }
        ],
        isError: true
      };
    }
  }

• src/tools/object-tools.js:13-15 (schema)

  Input schema validation using Zod for the sceneId parameter required by the getObjects tool.

  {
    sceneId: z.string().min(1).describe('Scene ID'),
  },

• src/tools/object-tools.js:11-39 (registration)

  Direct registration of the 'getObjects' tool using server.tool within the registerObjectTools function.

  server.tool(
    'getObjects',
    {
      sceneId: z.string().min(1).describe('Scene ID'),
    },
    async ({ sceneId }) => {
      try {
        const objects = await apiClient.getObjects(sceneId);
        return {
          content: [
            { 
              type: 'text', 
              text: JSON.stringify(objects, null, 2) 
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            { 
              type: 'text', 
              text: `Error retrieving objects: ${error.message}` 
            }
          ],
          isError: true
        };
      }
    }
  );

• src/utils/api-client.js:63-65 (helper)

  Supporting API client helper method that performs the HTTP GET request to retrieve objects from the Spline.design API.

  async getObjects(sceneId) {
    return this.request('GET', `/scenes/${sceneId}/objects`);
  }

• src/index.js:88-88 (registration)

  Top-level registration call that invokes registerObjectTools on the MCP server instance, thereby registering the getObjects tool among others.

  registerObjectTools(server);