Logo MCP

Instructions

Implementation Reference

• src/logo-extractor.ts:52-103 (handler)

  Core handler implementation for logo analysis: fetches HTML, extracts candidates from favicon, apple-touch-icon, og:image, CSS classes, brand images; validates, scores based on type/dimensions/aspect ratio, selects best candidate.

  async analyzeLogo(url: string): Promise<LogoAnalysis> {
    const startTime = Date.now();
    const analysis: LogoAnalysis = {
      url,
      candidates: [],
      extractionTime: 0,
      status: 'failed',
    };
  
    try {
      // 标准化URL
      const normalizedUrl = this.normalizeUrl(url);
      
      // 获取网页内容
      const html = await this.fetchHtml(normalizedUrl);
      const $ = cheerio.load(html);
      const baseUrl = this.getBaseUrl(normalizedUrl);
  
      // 提取各种类型的Logo候选
      const candidates: LogoCandidate[] = [];
  
      // 1. 提取favicon
      await this.extractFavicons($, baseUrl, candidates);
  
      // 2. 提取Apple Touch图标
      await this.extractAppleTouchIcons($, baseUrl, candidates);
  
      // 3. 提取OpenGraph图像
      await this.extractOpenGraphImages($, baseUrl, candidates);
  
      // 4. 提取通过CSS类名识别的Logo
      await this.extractLogoByClass($, baseUrl, candidates);
  
      // 5. 提取品牌相关图像
      await this.extractBrandImages($, baseUrl, candidates);
  
      // 过滤和评分候选Logo
      analysis.candidates = await this.filterAndScoreCandidates(candidates);
      
      // 选择最佳候选
      analysis.bestCandidate = this.selectBestCandidate(analysis.candidates);
      
      analysis.status = analysis.bestCandidate ? 'success' : 'no-logo';
      analysis.extractionTime = Date.now() - startTime;
  
      return analysis;
    } catch (error) {
      console.error('Logo分析失败:', error);
      analysis.extractionTime = Date.now() - startTime;
      return analysis;
    }
  }

• src/index.ts:143-180 (handler)

  MCP protocol handler for 'analyze_logo' tool: parses arguments, calls core analyzeLogo, handles onlyBestUrl option, returns formatted text response or error.

  private async handleAnalyzeLogo(args: any) {
    const { url, onlyBestUrl = false } = args;
    
    const analysis = await this.logoExtractor.analyzeLogo(url);
    
    if (onlyBestUrl) {
      // 只返回最佳Logo URL
      if (analysis.status === 'failed' || !analysis.bestCandidate) {
        return {
          content: [
            {
              type: 'text',
              text: `无法从 ${url} 找到Logo。请检查网站是否存在Logo或网络连接是否正常。`,
            },
          ],
        };
      }
      
      return {
        content: [
          {
            type: 'text',
            text: analysis.bestCandidate.url,
          },
        ],
      };
    } else {
      // 返回完整分析结果
      return {
        content: [
          {
            type: 'text',
            text: `Logo分析结果:\n${JSON.stringify(analysis, null, 2)}`,
          },
        ],
      };
    }
  }

• src/index.ts:64-82 (registration)

  Registration of 'analyze_logo' tool in ListToolsRequestHandler, including name, description, and input schema.

  {
    name: 'analyze_logo',
    description: '分析Logo的基本信息（尺寸、格式、质量等），支持onlyBestUrl参数只返回最佳Logo的URL',
    inputSchema: {
      type: 'object',
      properties: {
        url: {
          type: 'string',
          description: '要分析的网站URL',
        },
        onlyBestUrl: {
          type: 'boolean',
          description: '是否只返回最佳Logo的URL，默认为false',
          default: false,
        },
      },
      required: ['url'],
    },
  },

• src/logo-extractor.ts:6-19 (schema)

  TypeScript interfaces defining the structure of logo candidates and analysis results used by the tool.

  export interface LogoCandidate {
    url: string;
    type: 'favicon' | 'apple-touch-icon' | 'og:image' | 'logo-class' | 'brand-image';
    size?: { width: number; height: number };
    score: number; // 评分，用于选择最佳Logo
  }
  
  export interface LogoAnalysis {
    url: string;
    candidates: LogoCandidate[];
    bestCandidate?: LogoCandidate;
    extractionTime: number;
    status: 'success' | 'failed' | 'no-logo';
  }