Advanced TTS MCP Server

Instructions

Implementation Reference

• src/typescript/index.ts:482-497 (handler)

  Core implementation of the get_status tool. Retrieves the status and result of a TTS synthesis request from the activeRequests Map using the provided requestId.

  getStatus(requestId: string) {
    const request = this.activeRequests.get(requestId);
    if (request) {
      return {
        success: true,
        requestId,
        status: request.status,
        result: request.result
      };
    } else {
      return {
        success: false,
        error: `Request ${requestId} not found`
      };
    }
  }

• src/typescript/index.ts:708-720 (registration)

  Registration of the get_status tool in the list of available tools, including its description and input schema.

    name: 'get_status',
    description: 'Get processing status for a synthesis request',
    inputSchema: {
      type: 'object',
      properties: {
        requestId: {
          type: 'string',
          description: 'Request ID to check status for',
        },
      },
      required: ['requestId'],
    },
  },

• src/typescript/index.ts:807-818 (handler)

  MCP CallToolRequest handler for get_status. Calls ttsServer.getStatus and formats the response as MCP content.

  case 'get_status':
    const status = ttsServer.getStatus(args?.requestId as string);
    return {
      content: [
        {
          type: 'text',
          text: status.success 
            ? `🎙️ **Request Status**\n\n**ID:** ${status.requestId}\n**Status:** ${status.status}\n**Details:** ${JSON.stringify(status.result, null, 2)}`
            : `❌ **Error:** ${status.error}`,
        },
      ],
    };

• src/typescript/index.ts:710-719 (schema)

  Input schema validation for the get_status tool, requiring a requestId string.

  inputSchema: {
    type: 'object',
    properties: {
      requestId: {
        type: 'string',
        description: 'Request ID to check status for',
      },
    },
    required: ['requestId'],
  },