interactive-mcp

Instructions

Implementation Reference

• src/index.ts:162-167 (handler)

  The handler function that executes the tool logic: extracts projectName and message from arguments, sends an OS notification using node-notifier, and returns a confirmation response.

  (args) => {
    // Use inferred args type
    const { projectName, message } = args;
    notifier.notify({ title: projectName, message });
    return { content: [{ type: 'text', text: 'Notification sent.' }] };
  },

• src/index.ts:155-169 (registration)

  Registration of the message_complete_notification tool using server.tool(), including dynamic description handling, schema reference, and inline handler function.

    server.tool(
      'message_complete_notification',
      // Description is a string here, but handle consistently
      typeof messageCompleteNotificationTool.description === 'function'
        ? messageCompleteNotificationTool.description(globalTimeoutSeconds) // Should not happen based on definition, but safe
        : messageCompleteNotificationTool.description,
      messageCompleteNotificationTool.schema, // Use schema property
      (args) => {
        // Use inferred args type
        const { projectName, message } = args;
        notifier.notify({ title: projectName, message });
        return { content: [{ type: 'text', text: 'Notification sent.' }] };
      },
    );
  }

• src/tool-definitions/message-complete-notification.ts:66-69 (schema)

  Zod schema (raw shape) defining input parameters: projectName and message, used for input validation.

  const rawSchema: ZodRawShape = {
    projectName: z.string().describe('Notification title'),
    message: z.string().describe('Notification body'),
  };

• src/tool-definitions/message-complete-notification.ts:9-26 (schema)

  ToolCapabilityInfo including JSON schema for parameters (input schema advertised to MCP client).

  const capabilityInfo: ToolCapabilityInfo = {
    description: 'Notify when a response has completed via OS notification.',
    parameters: {
      type: 'object',
      properties: {
        projectName: {
          type: 'string',
          description:
            'Identifies the context/project making the notification (appears in notification title)',
        },
        message: {
          type: 'string',
          description: 'The specific notification text (appears in the body)',
        },
      },
      required: ['projectName', 'message'],
    },
  };

• src/tool-definitions/message-complete-notification.ts:72-76 (registration)

  Export of the ToolDefinition object aggregating capability, description, and schema, imported and used for registration in index.ts.

  export const messageCompleteNotificationTool: ToolDefinition = {
    capability: capabilityInfo,
    description: registrationDescription,
    schema: rawSchema, // Use the raw shape here
  };