LacyLights MCP Server

Instructions

Implementation Reference

• src/tools/project-tools.ts:96-117 (handler)

  The core handler function for the 'create_project' tool. Parses input using Zod schema, calls GraphQL client to create project, returns formatted response with project details and success message, handles errors.

  async createProject(args: z.infer<typeof CreateProjectSchema>) {
    const { name, description} = CreateProjectSchema.parse(args);
  
    try {
      const project = await this.graphqlClient.createProject({
        name,
        description
      });
  
      return {
        project: {
          id: project.id,
          name: project.name,
          description: project.description,
          createdAt: project.createdAt
        },
        message: `Successfully created project "${name}"`
      };
    } catch (error) {
      throw new Error(`Failed to create project: ${error}`);
    }
  }

• src/tools/project-tools.ts:9-12 (schema)

  Zod input schema used for validating arguments in the createProject handler.

  const CreateProjectSchema = z.object({
    name: z.string().describe('Project name'),
    description: z.string().optional().describe('Project description')
  });

• src/index.ts:97-113 (registration)

  Tool metadata registration (name, description, inputSchema) returned by ListToolsRequestHandler.

    name: "create_project",
    description: "Create a new lighting project",
    inputSchema: {
      type: "object",
      properties: {
        name: {
          type: "string",
          description: "Project name",
        },
        description: {
          type: "string",
          description: "Project description",
        },
      },
      required: ["name"],
    },
  },

• src/index.ts:1804-1816 (registration)

  Dispatch handler in CallToolRequestSchema switch statement that invokes the createProject method.

  case "create_project":
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            await this.projectTools.createProject(args as any),
            null,
            2,
          ),
        },
      ],
    };

• src/services/graphql-client-simple.ts:936-953 (helper)

  GraphQL client helper method that executes the createProject mutation and returns the new project data.

  async createProject(input: {
    name: string;
    description?: string;
  }): Promise<Project> {
    const mutation = `
      mutation CreateProject($input: CreateProjectInput!) {
        createProject(input: $input) {
          id
          name
          description
          createdAt
          updatedAt
        }
      }
    `;
  
    const data = await this.query(mutation, { input });
    return data.createProject;