MSFS SDK MCP Server

Instructions

Implementation Reference

• src/services/documentationService.ts:328-344 (handler)

  Core handler function implementing the list_categories tool logic, returning available documentation categories.

  async listCategories(): Promise<{ content: Array<{ type: string; text: string }> }> {
    const categoriesList = [
      '- **contents**: Search in documentation contents',
      '- **index**: Search in documentation index',
      '- **glossary**: Search in documentation glossary',
      '- **all**: Search in all categories (default: index)',
    ].join('\n');
  
    return {
      content: [
        {
          type: 'text',
          text: `Available MSFS SDK Documentation Categories:\n\n${categoriesList}\n\nUsage examples:\n- Search for "livery" in all categories: use category "all" or "index"\n- Search for "livery" in contents: use category "contents"\n- Search for "livery" in glossary: use category "glossary"`,
        },
      ],
    };
  }

• src/index.ts:81-88 (registration)

  Tool registration including name, description, and input schema in the ListToolsRequestHandler.

  {
    name: 'list_categories',
    description: 'List all available MSFS SDK documentation categories',
    inputSchema: {
      type: 'object',
      properties: {}
    }
  },

• src/index.ts:146-147 (registration)

  Dispatch handler in the main switch for direct tool calls.

  case 'list_categories':
    return await this.documentationService.listCategories();

• src/index.ts:176-177 (registration)

  Dispatch handler in the natural_language_query tool switch.

  case 'list_categories':
    return await this.documentationService.listCategories();

• src/services/naturalLanguageService.ts:33-39 (helper)

  Helper function in NaturalLanguageService that parses natural language input to invoke list_categories tool.

  // Match "List categories"
  if (command.toLowerCase() === "list categories") {
    return {
      tool: "list_categories",
      arguments: {}
    };
  }