ai_search_github

Instructions

Implementation Reference

• mcp_server_node.js:338-436 (handler)

  Handler function for 'ai_search_github' tool. Normalizes input arguments (query, type, language, sort), constructs GitHub search URL with filters, generates comprehensive details including search tips, related searches, and WebFetch instructions, saves to file, and returns formatted text response.

  case 'ai_search_github': {
    const rawQuery = normalizeString(args.query);
    const languageFilter = normalizeString(args.language);
    const requestedType = normalizeString(args.type).toLowerCase();
    const requestedSort = normalizeString(args.sort).toLowerCase();
  
    if (!rawQuery) {
      throw new Error('搜索关键词不能为空');
    }
  
    const typeNames = {
      repositories: '仓库',
      code: '代码',
      issues: '问题',
      users: '用户'
    };
  
    const sortNames = {
      stars: 'Star数',
      forks: 'Fork数',
      updated: '更新时间'
    };
  
    const typeKey = pickKey(typeNames, requestedType, 'repositories');
    const sortKey = pickKey(sortNames, requestedSort, 'stars');
  
    // 构建搜索URL
    let searchUrl = `https://github.com/search?q=${encodeURIComponent(rawQuery)}`;
    if (languageFilter) searchUrl += `+language:${encodeURIComponent(languageFilter)}`;
    searchUrl += `&type=${typeKey}&s=${sortKey}&o=desc`;
  
    // GitHub 搜索技巧
    const tips = [
      `Stars数量: ${rawQuery} stars:>1000`,
      `Fork数量: ${rawQuery} forks:>100`,
      `特定语言: ${rawQuery} language:javascript`,
      `最近更新: ${rawQuery} pushed:>2024-01-01`,
      `主题标签: ${rawQuery} topic:react`,
      `组织仓库: ${rawQuery} org:facebook`,
      `仓库大小: ${rawQuery} size:>10000`
    ];
  
    // 相关搜索建议
    const relatedSearches = [];
    if (typeKey === 'repositories') {
      relatedSearches.push(
        `${rawQuery} stars:>1000`,
        `${rawQuery} language:${languageFilter || 'javascript'}`,
        `awesome ${rawQuery}`
      );
    } else if (typeKey === 'code') {
      relatedSearches.push(
        `${rawQuery} extension:js`,
        `${rawQuery} path:src`,
        `${rawQuery} filename:README`
      );
    }
  
    const detailsContent = `🐙 GitHub 搜索\n\n` +
      `**搜索关键词**: ${rawQuery}\n` +
      `**搜索类型**: ${typeNames[typeKey]}\n` +
      `**编程语言**: ${languageFilter || '全部语言'}\n` +
      `**排序方式**: ${sortNames[sortKey]}\n\n` +
      `---\n\n` +
      `🔗 **搜索链接**: ${searchUrl}\n\n` +
      `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
      `\`\`\`javascript\n` +
      `WebFetch({\n` +
      `  url: "${searchUrl}",\n` +
      `  prompt: "提取前10个${typeNames[typeKey]}的名称、描述、${typeKey === 'repositories' ? 'Star数、Fork数' : '相关信息'}和链接"\n` +
      `})\n` +
      `\`\`\`\n\n` +
      `---\n\n` +
      `💡 **GitHub 高级搜索技巧**:\n` +
      tips.map(tip => `• ${tip}`).join('\n') +
      (relatedSearches.length > 0
        ? `\n\n📌 **相关搜索建议**:\n` + relatedSearches.map(s => `• ${s}`).join('\n')
        : '') +
      `\n\n📚 **更多搜索类型**:\n` +
      Object.keys(typeNames)
        .filter(t => t !== typeKey)
        .map((t) => {
          let altUrl = `https://github.com/search?q=${encodeURIComponent(rawQuery)}`;
          if (languageFilter) altUrl += `+language:${encodeURIComponent(languageFilter)}`;
          altUrl += `&type=${t}&s=${sortKey}&o=desc`;
          return `• ${typeNames[t]}: ${altUrl}`;
        })
        .join('\n');
  
    const filepath = await saveSearchResult('github-search', rawQuery, detailsContent);
  
    return makeTextResponse(
      `🐙 **GitHub搜索**\n\n` +
      `**关键词**: ${rawQuery}\n` +
      `**搜索链接**: ${searchUrl}\n\n` +
      `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
      `💡 使用 WebFetch 工具访问搜索链接获取结果`
    );
  }

• mcp_server_node.js:90-102 (schema)

  Tool metadata definition including name 'ai_search_github', description, and inputSchema specifying parameters: query (required), type (repositories|code|issues|users), language, sort (stars|forks|updated). This is part of AI_TOOLS array used for tool listing.

  {
    name: 'ai_search_github',
    description: '🐙 GitHub搜索 - 搜索GitHub仓库、代码、问题和用户\n\n【重要】此工具会返回GitHub搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。',
    inputSchema: {
      type: 'object',
      properties: {
        query: { type: 'string', description: '搜索关键词' },
        type: { type: 'string', enum: ['repositories', 'code', 'issues', 'users'], description: '搜索类型，默认repositories', default: 'repositories' },
        language: { type: 'string', description: '编程语言筛选（可选）' },
        sort: { type: 'string', enum: ['stars', 'forks', 'updated'], description: '排序方式，默认stars', default: 'stars' }
      },
      required: ['query']
    }

• mcp_server_node.js:252-254 (registration)

  Registers the list of tools (including ai_search_github) by handling ListToolsRequestSchema and returning the AI_TOOLS array.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: AI_TOOLS,
  }));