MCP Template

Instructions

Implementation Reference

• src/core/MCPServer.ts:215-221 (handler)

  Handler implementation for the 'create_record' tool. Validates input using CreateRecordArgsSchema and delegates creation to the data service.

  case 'create_record': {
    return await safeExecute(toolName, async () => {
      const args = validateInput(CreateRecordArgsSchema, request.params.arguments);
      const record = await this.dataService.createRecord(args.resourceUri, args.data);
      return record;
    });
  }

• src/core/MCPServer.ts:148-152 (registration)

  Registration of the 'create_record' tool in the list_tools handler, including name, description, and input schema reference.

  {
    name: 'create_record',
    description: 'Create a new record in a resource',
    inputSchema: getInputSchema(CreateRecordArgsSchema),
  },

• src/types/index.ts:82-85 (schema)

  Zod schema defining the input arguments for the create_record tool: resourceUri and data.

  export const CreateRecordArgsSchema = z.object({
    resourceUri: z.string().describe('URI of the resource'),
    data: z.record(z.unknown()).describe('Record data to create'),
  });

• src/examples/services/InMemoryDataService.ts:132-150 (helper)

  Example concrete implementation of createRecord method in InMemoryDataService, which the tool handler calls via dataService.

  public async createRecord(
    uri: string, 
    data: Record<string, unknown>
  ): Promise<Record<string, unknown>> {
    this.validateResource(uri);
    
    const id = data.id as string || uuidv4();
    const timestamp = new Date().toISOString();
    
    const record = {
      id,
      ...data,
      createdAt: timestamp,
      updatedAt: timestamp
    };
    
    this.data.get(uri)!.set(id, record);
    return record;
  }

• src/types/index.ts:36-36 (schema)

  Type signature for createRecord method in IDataService interface, defining the contract called by the tool handler.

  createRecord(_uri: string, _data: { [key: string]: unknown }): Promise<{ [key: string]: unknown }>;