Weblate MCP Server

Instructions

Implementation Reference

• src/tools/statistics.tool.ts:218-249 (handler)

  The @Tool-decorated handler function implementing the core logic for the getLanguageStatistics tool. It fetches statistics from the service, formats them, and returns a structured response or error.

  @Tool({
    name: 'getLanguageStatistics',
    description: 'Get statistics for a specific language across all projects',
    parameters: z.object({
      languageCode: z.string().describe('The language code (e.g., en, es, fr)'),
    }),
  })
  async getLanguageStatistics({ languageCode }: { languageCode: string }) {
    try {
      const stats = await this.statisticsService.getLanguageStatistics(languageCode);
  
      return {
        content: [
          {
            type: 'text',
            text: this.formatLanguageStatistics(languageCode, stats),
          },
        ],
      };
    } catch (error) {
      this.logger.error(`Failed to get language statistics for ${languageCode}`, error);
      return {
        content: [
          {
            type: 'text',
            text: `Error getting language statistics: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/statistics.tool.ts:221-223 (schema)

  Zod schema defining the input parameter 'languageCode' for the tool.

  parameters: z.object({
    languageCode: z.string().describe('The language code (e.g., en, es, fr)'),
  }),

• src/app.module.ts:74-80 (registration)

  The WeblateStatisticsTool class (containing the getLanguageStatistics handler) is registered as a provider in the root AppModule, making its tools available via MCP.

    WeblateProjectsTool,
    WeblateComponentsTool,
    WeblateLanguagesTool,
    WeblateTranslationsTool,
    WeblateChangesTool,
    WeblateStatisticsTool,
  ],

• src/services/weblate/statistics.service.ts:106-123 (helper)

  Helper service method that calls the Weblate API to retrieve raw language statistics data, invoked by the tool handler.

  async getLanguageStatistics(languageCode: string) {
    try {
      const response = await languagesStatisticsRetrieve({
        client: this.clientService.getClient(),
        path: { code: languageCode },
        query: { format: 'json' },
      });
  
      if (response.error) {
        throw new Error(`Failed to get language statistics: ${response.error}`);
      }
  
      return response.data;
    } catch (error) {
      this.logger.error(`Failed to get language statistics for ${languageCode}`, error);
      throw error;
    }
  }

• src/tools/statistics.tool.ts:445-471 (helper)

  Private helper method to format the raw statistics into a human-readable markdown string for the tool response.

    private formatLanguageStatistics(languageCode: string, stats: any): string {
      const getStatValue = (key: string, defaultValue = 'N/A') => {
        return stats?.[key] !== undefined ? stats[key] : defaultValue;
      };
  
      const formatPercent = (value: any) => {
        return typeof value === 'number' ? `${value.toFixed(1)}%` : 'N/A';
      };
  
      return `## 🌐 Language Statistics: ${stats?.name || languageCode}
  
  **Language Details:**
  - 📛 Name: ${getStatValue('name')}
  - 🔤 Code: ${getStatValue('code')}
  - 📍 Direction: ${getStatValue('direction', 'ltr')}
  
  **Overall Progress:**
  - 🎯 Translated: ${formatPercent(getStatValue('translated_percent'))}
  - ✅ Approved: ${formatPercent(getStatValue('approved_percent'))}
  - ❌ Untranslated: ${formatPercent(getStatValue('nottranslated_percent'))}
  
  **String Counts:**
  - 📝 Total: ${getStatValue('total')}
  - ✅ Translated: ${getStatValue('translated')}
  - 🎯 Approved: ${getStatValue('approved')}
  - ❌ Untranslated: ${getStatValue('nottranslated')}`;
    }