get_random_wallpaper

Instructions

Implementation Reference

• src/main/index.ts:84-94 (registration)

  Registers the 'get_random_wallpaper' MCP tool, including input schema with optional resolution and market parameters using Zod, description, and a thin handler delegating to WallpaperController.

  server.tool(
      'get_random_wallpaper',
      '从Bing壁纸获取随机壁纸，返回壁纸的URL、标题和描述信息',
      {
          resolution: z.string().optional().describe('壁纸分辨率，可选值：1920x1080, 3840x2160, 1366x768等，默认为1920x1080'),
          market: z.string().optional().describe('地区市场，如zh-CN(中国), en-US(美国)等，默认为zh-CN'),
      },
      async ({ resolution = AppConfig.DEFAULT_WALLPAPER_RESOLUTION, market = AppConfig.DEFAULT_MARKET }) => {
          return await wallpaperController.getRandomWallpaper(resolution, market);
      }
  );

• src/main/controllers/WallpaperController.ts:10-32 (handler)

  Controller handler that invokes the wallpaper service, stringifies the result as JSON, and formats it into MCP-compatible response structure with error handling.

  async getRandomWallpaper(resolution: string = '1920x1080', market: string = 'zh-CN'): Promise<{ content: Array<{ type: 'text'; text: string }> }> {
    try {
      const wallpaperInfo = await this.wallpaperService.getRandomWallpaper(resolution, market);
      
      return {
        content: [
          {
            type: 'text' as const,
            text: JSON.stringify(wallpaperInfo, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `获取壁纸时出错: ${error instanceof Error ? error.message : '未知错误'}`,
          },
        ],
      };
    }
  }

• src/main/services/WallpaperService.ts:5-27 (handler)

  Core tool logic: constructs Bing wallpaper API URL, performs HTTPS request, parses JSON response, extracts image details, and returns structured WallpaperInfo.

  async getRandomWallpaper(resolution: string = '1920x1080', market: string = 'zh-CN'): Promise<WallpaperInfo> {
    const apiUrl = `https://www.bing.com/HPImageArchive.aspx?format=js&idx=0&n=1&mkt=${market}&uhd=1&uhdwidth=${resolution.split('x')[0]}&uhdheight=${resolution.split('x')[1]}`;
    
    const wallpaperData = await this.makeHttpRequest(apiUrl);
    
    if (!wallpaperData.images || wallpaperData.images.length === 0) {
      throw new Error('未找到可用的壁纸');
    }
  
    const wallpaper = wallpaperData.images[0];
    const baseUrl = 'https://www.bing.com';
    const imageUrl = baseUrl + wallpaper.url;
    
    return {
      title: wallpaper.title,
      description: wallpaper.copyright,
      imageUrl: imageUrl,
      resolution: resolution,
      date: wallpaper.startdate,
      market: market,
      fullUrl: imageUrl
    };
  }

• src/main/index.ts:87-90 (schema)

  Zod input schema for the tool parameters: optional resolution and market strings.

  {
      resolution: z.string().optional().describe('壁纸分辨率，可选值：1920x1080, 3840x2160, 1366x768等，默认为1920x1080'),
      market: z.string().optional().describe('地区市场，如zh-CN(中国), en-US(美国)等，默认为zh-CN'),
  },

• src/main/services/WallpaperService.ts:29-48 (helper)

  Private helper method to perform HTTPS GET request to Bing API, accumulate response data, parse JSON, with error handling.

  private makeHttpRequest(url: string): Promise<any> {
    return new Promise((resolve, reject) => {
      https.get(url, (res) => {
        let data = '';
        res.on('data', (chunk) => {
          data += chunk;
        });
        res.on('end', () => {
          try {
            const jsonData = JSON.parse(data);
            resolve(jsonData);
          } catch (error) {
            reject(new Error('解析壁纸数据失败'));
          }
        });
      }).on('error', (error) => {
        reject(new Error(`获取壁纸失败: ${error.message}`));
      });
    });
  }