Smart Search MCP

Overview Schema Related Servers Score Discussions

ai_search_csdn

Search CSDN technical blogs and Q&A content to find programming solutions and tutorials. Returns search URLs for accessing detailed results through web fetching tools.

Instructions

📝 CSDN搜索 - 搜索CSDN技术博客和问答

【重要】此工具会返回CSDN搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes	搜索关键词
`type`	No	搜索类型	all

Implementation Reference

mcp_server_node.js:167-177 (schema)

Schema definition for the ai_search_csdn tool, including input parameters: query (required string), type (enum: blog/ask/all).

{
  name: 'ai_search_csdn',
  description: '📝 CSDN搜索 - 搜索CSDN技术博客和问答\n\n【重要】此工具会返回CSDN搜索URL，Claude Code应该使用WebFetch工具访问该URL以获取真实搜索结果。',
  inputSchema: {
    type: 'object',
    properties: {
      query: { type: 'string', description: '搜索关键词' },
      type: { type: 'string', enum: ['blog', 'ask', 'all'], description: '搜索类型', default: 'all' }
    },
    required: ['query']
  }

mcp_server_node.js:824-939 (handler)

Handler for ai_search_csdn (shared with similar domestic search tools): validates query, selects CSDN-specific search URL and platform info, generates detailed Markdown response with WebFetch instructions, saves to file, returns text response.

case 'ai_search_csdn':
case 'ai_search_juejin':
case 'ai_search_segmentfault':
case 'ai_search_cnblogs':
case 'ai_search_oschina':
case 'ai_search_aliyun_docs':
case 'ai_search_tencent_docs': {
  const rawQuery = normalizeString(args.query);

  if (!rawQuery) {
    throw new Error('搜索关键词不能为空');
  }

  const searchUrls = {
    ai_search_csdn: `https://so.csdn.net/so/search?q=${encodeURIComponent(rawQuery)}`,
    ai_search_juejin: `https://juejin.cn/search?query=${encodeURIComponent(rawQuery)}`,
    ai_search_segmentfault: `https://segmentfault.com/search?q=${encodeURIComponent(rawQuery)}`,
    ai_search_cnblogs: `https://zzk.cnblogs.com/s?w=${encodeURIComponent(rawQuery)}`,
    ai_search_oschina: `https://www.oschina.net/search?scope=all&q=${encodeURIComponent(rawQuery)}`,
    ai_search_aliyun_docs: `https://help.aliyun.com/search?spm=a2c4g.11186623.0.0&k=${encodeURIComponent(rawQuery)}`,
    ai_search_tencent_docs: `https://cloud.tencent.com/search?s=doc&keyword=${encodeURIComponent(rawQuery)}`
  };

  const platformInfo = {
    ai_search_csdn: {
      name: 'CSDN',
      icon: '📝',
      description: '中国最大的IT社区和服务平台',
      tips: ['博客文章', '技术问答', '代码片段', '下载资源'],
      homepage: 'https://www.csdn.net/',
      toolKey: 'csdn-search'
    },
    ai_search_juejin: {
      name: '掘金',
      icon: '💎',
      description: '面向开发者的技术内容分享平台',
      tips: ['前端开发', '后端开发', 'Android', 'iOS', '人工智能'],
      homepage: 'https://juejin.cn/',
      toolKey: 'juejin-search'
    },
    ai_search_segmentfault: {
      name: 'SegmentFault',
      icon: '🔧',
      description: '中文技术问答社区',
      tips: ['技术问答', '技术文章', '活动沙龙', '编程挑战'],
      homepage: 'https://segmentfault.com/',
      toolKey: 'sf-search'
    },
    ai_search_cnblogs: {
      name: '博客园',
      icon: '📚',
      description: '开发者的网上家园',
      tips: ['.NET', 'C#', 'Java', 'Python', '数据库'],
      homepage: 'https://www.cnblogs.com/',
      toolKey: 'cnblogs-search'
    },
    ai_search_oschina: {
      name: '开源中国',
      icon: '🌐',
      description: '中国最大的开源技术社区',
      tips: ['开源项目', '技术资讯', '代码托管', '协作翻译'],
      homepage: 'https://www.oschina.net/',
      toolKey: 'oschina-search'
    },
    ai_search_aliyun_docs: {
      name: '阿里云文档',
      icon: '☁️',
      description: '阿里云产品文档中心',
      tips: ['ECS', 'OSS', 'RDS', 'SLB', '容器服务'],
      homepage: 'https://help.aliyun.com/',
      toolKey: 'aliyun-docs'
    },
    ai_search_tencent_docs: {
      name: '腾讯云文档',
      icon: '☁️',
      description: '腾讯云产品文档中心',
      tips: ['CVM', 'COS', 'CDN', 'SCF', '数据库'],
      homepage: 'https://cloud.tencent.com/document/product',
      toolKey: 'tencent-docs'
    }
  };

  const info = platformInfo[name];
  const searchUrl = searchUrls[name];

  const detailsContent = `${info.icon} ${info.name} 搜索\n\n` +
    `**搜索关键词**: ${rawQuery}\n` +
    `**平台介绍**: ${info.description}\n\n` +
    `---\n\n` +
    `🔗 **搜索链接**: ${searchUrl}\n\n` +
    `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
    `\`\`\`javascript\n` +
    `WebFetch({\n` +
    `  url: "${searchUrl}",\n` +
    `  prompt: "提取前10条搜索结果（标题、作者、发布时间、摘要、链接）"\n` +
    `})\n` +
    `\`\`\`\n\n` +
    `---\n\n` +
    `💡 **${info.name} 热门主题**:\n` +
    info.tips.map(tip => `• ${tip}`).join(' | ') +
    `\n\n🏠 **平台首页**: ${info.homepage}\n\n` +
    `📌 **搜索建议**:\n` +
    `• 使用精确关键词获得更好的结果\n` +
    `• 结合多个平台搜索可获得更全面的信息\n` +
    `• 关注文章的发布时间，优先查看最新内容`;

  const filepath = await saveSearchResult(info.toolKey, rawQuery, detailsContent);

  return makeTextResponse(
    `${info.icon} **${info.name}搜索**\n\n` +
    `**关键词**: ${rawQuery}\n` +
    `**搜索链接**: ${searchUrl}\n\n` +
    `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
    `💡 使用 WebFetch 工具访问搜索链接获取结果`
  );
}

mcp_server_node.js:252-254 (registration)
Registers the ai_search_csdn tool (among others in AI_TOOLS array) for the ListToolsRequestSchema.
```
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: AI_TOOLS,
}));
```

mcp_server_node.js:837-939 (helper)

Helper configuration objects for search URLs and platform information used in the handler for ai_search_csdn.

  const searchUrls = {
    ai_search_csdn: `https://so.csdn.net/so/search?q=${encodeURIComponent(rawQuery)}`,
    ai_search_juejin: `https://juejin.cn/search?query=${encodeURIComponent(rawQuery)}`,
    ai_search_segmentfault: `https://segmentfault.com/search?q=${encodeURIComponent(rawQuery)}`,
    ai_search_cnblogs: `https://zzk.cnblogs.com/s?w=${encodeURIComponent(rawQuery)}`,
    ai_search_oschina: `https://www.oschina.net/search?scope=all&q=${encodeURIComponent(rawQuery)}`,
    ai_search_aliyun_docs: `https://help.aliyun.com/search?spm=a2c4g.11186623.0.0&k=${encodeURIComponent(rawQuery)}`,
    ai_search_tencent_docs: `https://cloud.tencent.com/search?s=doc&keyword=${encodeURIComponent(rawQuery)}`
  };

  const platformInfo = {
    ai_search_csdn: {
      name: 'CSDN',
      icon: '📝',
      description: '中国最大的IT社区和服务平台',
      tips: ['博客文章', '技术问答', '代码片段', '下载资源'],
      homepage: 'https://www.csdn.net/',
      toolKey: 'csdn-search'
    },
    ai_search_juejin: {
      name: '掘金',
      icon: '💎',
      description: '面向开发者的技术内容分享平台',
      tips: ['前端开发', '后端开发', 'Android', 'iOS', '人工智能'],
      homepage: 'https://juejin.cn/',
      toolKey: 'juejin-search'
    },
    ai_search_segmentfault: {
      name: 'SegmentFault',
      icon: '🔧',
      description: '中文技术问答社区',
      tips: ['技术问答', '技术文章', '活动沙龙', '编程挑战'],
      homepage: 'https://segmentfault.com/',
      toolKey: 'sf-search'
    },
    ai_search_cnblogs: {
      name: '博客园',
      icon: '📚',
      description: '开发者的网上家园',
      tips: ['.NET', 'C#', 'Java', 'Python', '数据库'],
      homepage: 'https://www.cnblogs.com/',
      toolKey: 'cnblogs-search'
    },
    ai_search_oschina: {
      name: '开源中国',
      icon: '🌐',
      description: '中国最大的开源技术社区',
      tips: ['开源项目', '技术资讯', '代码托管', '协作翻译'],
      homepage: 'https://www.oschina.net/',
      toolKey: 'oschina-search'
    },
    ai_search_aliyun_docs: {
      name: '阿里云文档',
      icon: '☁️',
      description: '阿里云产品文档中心',
      tips: ['ECS', 'OSS', 'RDS', 'SLB', '容器服务'],
      homepage: 'https://help.aliyun.com/',
      toolKey: 'aliyun-docs'
    },
    ai_search_tencent_docs: {
      name: '腾讯云文档',
      icon: '☁️',
      description: '腾讯云产品文档中心',
      tips: ['CVM', 'COS', 'CDN', 'SCF', '数据库'],
      homepage: 'https://cloud.tencent.com/document/product',
      toolKey: 'tencent-docs'
    }
  };

  const info = platformInfo[name];
  const searchUrl = searchUrls[name];

  const detailsContent = `${info.icon} ${info.name} 搜索\n\n` +
    `**搜索关键词**: ${rawQuery}\n` +
    `**平台介绍**: ${info.description}\n\n` +
    `---\n\n` +
    `🔗 **搜索链接**: ${searchUrl}\n\n` +
    `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
    `\`\`\`javascript\n` +
    `WebFetch({\n` +
    `  url: "${searchUrl}",\n` +
    `  prompt: "提取前10条搜索结果（标题、作者、发布时间、摘要、链接）"\n` +
    `})\n` +
    `\`\`\`\n\n` +
    `---\n\n` +
    `💡 **${info.name} 热门主题**:\n` +
    info.tips.map(tip => `• ${tip}`).join(' | ') +
    `\n\n🏠 **平台首页**: ${info.homepage}\n\n` +
    `📌 **搜索建议**:\n` +
    `• 使用精确关键词获得更好的结果\n` +
    `• 结合多个平台搜索可获得更全面的信息\n` +
    `• 关注文章的发布时间，优先查看最新内容`;

  const filepath = await saveSearchResult(info.toolKey, rawQuery, detailsContent);

  return makeTextResponse(
    `${info.icon} **${info.name}搜索**\n\n` +
    `**关键词**: ${rawQuery}\n` +
    `**搜索链接**: ${searchUrl}\n\n` +
    `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
    `💡 使用 WebFetch 工具访问搜索链接获取结果`
  );
}

mcp_server_node.js:256-955 (registration)

Registers the CallToolRequestSchema handler which includes the switch case for executing ai_search_csdn.

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  try {
    switch (name) {
      // === 搜索工具处理 ===
      case 'ai_search_web': {
        const rawQuery = normalizeString(args.query);
        const requestedEngine = normalizeString(args.engine).toLowerCase();
        const resolvedCount = clampNumber(args.count, 1, 50, 10);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrls = {
          google: `https://www.google.com/search?q=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`,
          bing: `https://www.bing.com/search?q=${encodeURIComponent(rawQuery)}&count=${resolvedCount}`,
          baidu: `https://www.baidu.com/s?wd=${encodeURIComponent(rawQuery)}&rn=${resolvedCount}`,
          sogou: `https://www.sogou.com/web?query=${encodeURIComponent(rawQuery)}&num=${resolvedCount}`
        };

        const engineNames = {
          google: 'Google',
          bing: 'Bing (必应)',
          baidu: '百度',
          sogou: '搜狗'
        };

        const resolvedEngine = pickKey(searchUrls, requestedEngine, 'baidu');
        const searchUrl = searchUrls[resolvedEngine];

        const tips = [
          `精确匹配: "${rawQuery}"`,
          `排除关键词: ${rawQuery} -排除词`,
          `限定站点: site:github.com ${rawQuery}`,
          `文件类型: ${rawQuery} filetype:pdf`,
          `时间范围: ${rawQuery} after:2023`,
        ];

        const relatedSearches = [
          `${rawQuery} 教程`,
          `${rawQuery} 最佳实践`,
          `${rawQuery} 示例`,
          `${rawQuery} 文档`
        ];

        const detailsContent = `🔍 网络搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**搜索引擎**: ${engineNames[resolvedEngine]}\n` +
          `**期望结果数**: ${resolvedCount} 条\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前${resolvedCount}条搜索结果，包括：标题、链接、摘要"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **高级搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n📌 **相关搜索建议**:\n` +
          relatedSearches.map(s => `• ${s}`).join('\n') +
          `\n\n🌐 **其他搜索引擎**:\n` +
          Object.keys(searchUrls)
            .filter(e => e !== resolvedEngine)
            .map(e => `• ${engineNames[e]}: ${searchUrls[e]}`)
            .join('\n');

        const filepath = await saveSearchResult('web-search', rawQuery, detailsContent);

        return makeTextResponse(
          `🔍 **网络搜索** (${engineNames[resolvedEngine]})\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      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 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_stackoverflow': {
        const rawQuery = normalizeString(args.query);
        const tagsInput = normalizeString(args.tags);
        const requestedSort = normalizeString(args.sort).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const sortNames = {
          relevance: '相关性',
          votes: '投票数',
          creation: '创建时间',
          activity: '活跃度'
        };

        const sortKey = pickKey(sortNames, requestedSort, 'relevance');

        let searchQuery = rawQuery;
        let tagList = [];
        if (tagsInput) {
          tagList = tagsInput
            .split(',')
            .map((t) => normalizeString(t))
            .filter(Boolean);
          if (tagList.length > 0) {
            searchQuery += ` ${tagList.map(t => `[${t}]`).join(' ')}`;
          }
        }

        const searchUrl = `https://stackoverflow.com/search?q=${encodeURIComponent(searchQuery)}&sort=${sortKey}`;
        const tagsDisplay = tagList.length > 0 ? tagList.join(', ') : '无';

        // StackOverflow 搜索技巧
        const tips = [
          `标签搜索: [javascript] ${rawQuery}`,
          `已回答问题: ${rawQuery} is:answer`,
          `已接受答案: ${rawQuery} isaccepted:yes`,
          `投票数筛选: ${rawQuery} score:5..`,
          `多个标签: [react] [hooks] ${rawQuery}`,
          `代码搜索: code:"${rawQuery}"`,
          `标题搜索: title:"${rawQuery}"`
        ];

        // 热门技术标签推荐
        const popularTags = [
          'javascript', 'python', 'java', 'react', 'node.js',
          'typescript', 'html', 'css', 'sql', 'docker'
        ];

        const detailsContent = `💬 StackOverflow 搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**标签筛选**: ${tagsDisplay}\n` +
          `**排序方式**: ${sortNames[sortKey]}\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前10个问题的标题、投票数、回答数、是否已解决和链接"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **高级搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n🏷️ **热门技术标签**:\n` +
          popularTags.map(tag => `• [${tag}]`).join(' ') +
          `\n\n📊 **其他排序方式**:\n` +
          Object.keys(sortNames)
            .filter(s => s !== sortKey)
            .map((s) =>
              `• ${sortNames[s]}: https://stackoverflow.com/search?q=${encodeURIComponent(searchQuery)}&sort=${s}`
            )
            .join('\n');

        const filepath = await saveSearchResult('stackoverflow-search', rawQuery, detailsContent);

        return makeTextResponse(
          `💬 **StackOverflow搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_npm': {
        const rawQuery = normalizeString(args.query);
        const resolvedSize = clampNumber(args.size, 1, 100, 10);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrl = `https://www.npmjs.com/search?q=${encodeURIComponent(rawQuery)}`;
        const registryUrl = `https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(rawQuery)}&size=${resolvedSize}`;

        // NPM 搜索技巧
        const tips = [
          `精确包名: ${rawQuery} (使用完整包名)`,
          `关键词搜索: keywords:${rawQuery}`,
          `作者搜索: author:${rawQuery}`,
          `维护者: maintainer:${rawQuery}`,
          `作用域包: @scope/${rawQuery}`,
          `特定版本: ${rawQuery}@latest`
        ];

        // 相关搜索建议
        const relatedSearches = [
          `${rawQuery} typescript`,
          `${rawQuery} cli`,
          `${rawQuery} plugin`,
          `@types/${rawQuery}`
        ];

        // 热门类别推荐
        const categories = [
          'react', 'vue', 'express', 'webpack',
          'babel', 'eslint', 'testing', 'cli-tools'
        ];

        const detailsContent = `📦 NPM 包搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**期望结果数**: ${resolvedSize} 个\n\n` +
          `---\n\n` +
          `🔗 **网页搜索**: ${searchUrl}\n` +
          `🔗 **API搜索**: ${registryUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `// 方式1: 网页搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前${resolvedSize}个包的：包名、描述、版本号、周下载量、最后更新时间"\n` +
          `})\n\n` +
          `// 方式2: API搜索 (推荐，结构化数据)\n` +
          `WebFetch({\n` +
          `  url: "${registryUrl}",\n` +
          `  prompt: "解析JSON数据，提取包的名称、描述、版本、作者和下载统计"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **NPM 搜索技巧**:\n` +
          tips.map(tip => `• ${tip}`).join('\n') +
          `\n\n📌 **相关搜索建议**:\n` +
          relatedSearches.map(s => `• ${s}`).join('\n') +
          `\n\n🏷️ **热门包分类**:\n` +
          categories.map(cat => `• ${cat}`).join(' ') +
          `\n\n📚 **直接访问包详情**: https://www.npmjs.com/package/${rawQuery}`;

        const filepath = await saveSearchResult('npm-search', rawQuery, detailsContent);

        return makeTextResponse(
          `📦 **NPM包搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_docs': {
        const rawQuery = normalizeString(args.query);
        const requestedFramework = normalizeString(args.framework).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const docUrls = {
          react: `https://react.dev/?search=${encodeURIComponent(rawQuery)}`,
          vue: `https://cn.vuejs.org/search/?query=${encodeURIComponent(rawQuery)}`,
          angular: `https://angular.io/api?query=${encodeURIComponent(rawQuery)}`,
          nodejs: `https://nodejs.org/api/all.html`,
          python: `https://docs.python.org/zh-cn/3/search.html?q=${encodeURIComponent(rawQuery)}`,
          java: `https://docs.oracle.com/en/java/javase/21/docs/api/search.html?q=${encodeURIComponent(rawQuery)}`,
          general: `https://developer.mozilla.org/zh-CN/search?q=${encodeURIComponent(rawQuery)}`
        };

        const frameworkNames = {
          react: 'React',
          vue: 'Vue.js',
          angular: 'Angular',
          nodejs: 'Node.js',
          python: 'Python',
          java: 'Java',
          general: 'MDN Web Docs'
        };

        const frameworkTips = {
          react: ['Hooks', 'Components', 'Props', 'State', 'Context', 'useEffect'],
          vue: ['组合式API', '响应式', 'computed', 'watch', '组件', '指令'],
          angular: ['Directives', 'Services', 'Modules', 'Components', 'Routing'],
          nodejs: ['fs', 'http', 'path', 'events', 'stream', 'crypto'],
          python: ['列表推导', '装饰器', '生成器', '异步', 'pandas', 'numpy'],
          java: ['Collections', 'Stream', 'Optional', 'Lambda', 'Generic'],
          general: ['HTML', 'CSS', 'JavaScript', 'Web API', 'HTTP']
        };

        const resolvedFramework = pickKey(docUrls, requestedFramework, 'general');

        const detailsContent = `📚 ${frameworkNames[resolvedFramework]} 文档搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**框架/语言**: ${frameworkNames[resolvedFramework]}\n\n` +
          `---\n\n` +
          `🔗 **文档链接**: ${docUrls[resolvedFramework]}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取文档内容**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${docUrls[resolvedFramework]}",\n` +
          `  prompt: "查找'${rawQuery}'相关的：API说明、参数列表、返回值、使用示例、注意事项"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **${frameworkNames[resolvedFramework]} 常用主题**:\n` +
          frameworkTips[resolvedFramework].map(tip => `• ${tip}`).join(' | ') +
          `\n\n📚 **其他文档资源**:\n` +
          Object.keys(docUrls)
            .filter(f => f !== resolvedFramework)
            .map(f => `• ${frameworkNames[f]}: ${docUrls[f].replace(/\?.*$/, '')}`)
            .slice(0, 4)
            .join('\n');

        const filepath = await saveSearchResult('docs-search', rawQuery, detailsContent);

        return makeTextResponse(
          `📚 **技术文档搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${docUrls[resolvedFramework]}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_api_reference': {
        const rawApiName = normalizeString(args.api_name);
        const rawPlatform = normalizeString(args.platform);

        if (!rawApiName) {
          throw new Error('API名称不能为空');
        }
        if (!rawPlatform) {
          throw new Error('平台/库名称不能为空');
        }

        const searchUrls = {
          google: `https://www.google.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName} API documentation`)}`,
          devdocs: `https://devdocs.io/#q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}`,
          github: `https://github.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}&type=code`
        };

        // 常见平台的直接文档链接
        const platformDocs = {
          express: `https://expressjs.com/en/api.html`,
          axios: `https://axios-http.com/docs/api_intro`,
          lodash: `https://lodash.com/docs/`,
          mongoose: `https://mongoosejs.com/docs/api.html`,
          sequelize: `https://sequelize.org/api/`,
          'socket.io': `https://socket.io/docs/v4/`,
          jwt: `https://github.com/auth0/node-jsonwebtoken#readme`
        };

        const directDoc = platformDocs[rawPlatform.toLowerCase()];

        const detailsContent = `🔗 API 参考搜索\n\n` +
          `**平台/库**: ${rawPlatform}\n` +
          `**API名称**: ${rawApiName}\n\n` +
          `---\n\n` +
          `🔍 **搜索资源**:\n` +
          `• Google: ${searchUrls.google}\n` +
          `• DevDocs: ${searchUrls.devdocs}\n` +
          `• GitHub: ${searchUrls.github}\n` +
          (directDoc ? `• 官方文档: ${directDoc}\n` : '') +
          `\n⚠️ **请使用 WebFetch 工具获取API文档**:\n` +
          `\`\`\`javascript\n` +
          `// 推荐：先搜索官方文档\n` +
          `WebFetch({\n` +
          `  url: "${directDoc || searchUrls.google}",\n` +
          `  prompt: "查找'${rawApiName}'的：函数签名、参数说明、返回值、使用示例、注意事项"\n` +
          `})\n\n` +
          `// 备选：在DevDocs搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrls.devdocs}",\n` +
          `  prompt: "提取${rawPlatform}的${rawApiName} API详细文档"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **查询提示**:\n` +
          `• 精确搜索: "${rawPlatform}.${rawApiName}()"\n` +
          `• 示例代码: ${rawPlatform} ${rawApiName} example\n` +
          `• 参数说明: ${rawPlatform} ${rawApiName} parameters\n` +
          `• 错误处理: ${rawPlatform} ${rawApiName} error handling\n\n` +
          `📚 **相关资源**:\n` +
          `• NPM包: https://www.npmjs.com/package/${rawPlatform}\n` +
          `• GitHub仓库: https://github.com/search?q=${encodeURIComponent(rawPlatform)}&type=repositories\n` +
          `• StackOverflow: https://stackoverflow.com/search?q=${encodeURIComponent(`${rawPlatform} ${rawApiName}`)}`;

        const filepath = await saveSearchResult('api-search', rawApiName, detailsContent);

        return makeTextResponse(
          `🔗 **API参考搜索**\n\n` +
          `**关键词**: ${rawApiName}\n` +
          `**搜索链接**: ${directDoc || searchUrls.google}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      // === 国内搜索工具 ===
      case 'ai_search_wechat_docs': {
        const rawQuery = normalizeString(args.query);
        const platformInput = normalizeString(args.platform).toLowerCase();

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const platformUrls = {
          miniprogram: `https://developers.weixin.qq.com/miniprogram/dev/framework/`,
          officialaccount: `https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html`,
          open: `https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/getting_started/how_to_read.html`,
          payment: `https://pay.weixin.qq.com/wiki/doc/apiv3/index.shtml`,
          all: `https://developers.weixin.qq.com/`
        };

        // 构建搜索URL（微信文档使用百度站内搜索）
        const searchUrl = `https://www.baidu.com/s?wd=site:developers.weixin.qq.com ${encodeURIComponent(rawQuery)}`;

        const platformNames = {
          miniprogram: '小程序',
          officialaccount: '公众号',
          open: '开放平台',
          payment: '微信支付',
          all: '全平台'
        };

        const resolvedPlatform = pickKey(platformNames, platformInput, 'all');

        // 常用API分类
        const apiCategories = {
          miniprogram: ['wx.request', 'wx.getUserInfo', 'wx.login', 'wx.showToast', 'wx.navigateTo'],
          officialaccount: ['接收消息', '发送消息', '自定义菜单', '网页授权', '模板消息'],
          payment: ['JSAPI支付', '小程序支付', 'APP支付', '退款', '对账单']
        };

        const detailsContent = `📱 微信开发者文档搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**平台类型**: ${platformNames[resolvedPlatform]}\n\n` +
          `---\n\n` +
          `🔗 **站内搜索**: ${searchUrl}\n` +
          `🔗 **${platformNames[resolvedPlatform]}文档**: ${platformUrls[resolvedPlatform]}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `// 方式1: 百度站内搜索\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取微信文档中关于'${rawQuery}'的搜索结果"\n` +
          `})\n\n` +
          `// 方式2: 直接访问文档首页\n` +
          `WebFetch({\n` +
          `  url: "${platformUrls[resolvedPlatform]}",\n` +
          `  prompt: "在文档中查找'${rawQuery}'相关内容"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **常用${platformNames[resolvedPlatform]}API**:\n` +
          (apiCategories[resolvedPlatform] || ['基础组件', 'API接口', '开发工具']).map(api => `• ${api}`).join(' | ') +
          `\n\n📚 **其他微信平台**:\n` +
          Object.keys(platformNames)
            .filter(p => p !== resolvedPlatform)
            .map(p => `• ${platformNames[p]}: ${platformUrls[p]}`)
            .slice(0, 3)
            .join('\n') +
          `\n\n🔗 **开发者社区**: https://developers.weixin.qq.com/community/`;

        const filepath = await saveSearchResult('wechat-docs', rawQuery, detailsContent);

        return makeTextResponse(
          `📱 **微信开发者文档搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      case 'ai_search_csdn':
      case 'ai_search_juejin':
      case 'ai_search_segmentfault':
      case 'ai_search_cnblogs':
      case 'ai_search_oschina':
      case 'ai_search_aliyun_docs':
      case 'ai_search_tencent_docs': {
        const rawQuery = normalizeString(args.query);

        if (!rawQuery) {
          throw new Error('搜索关键词不能为空');
        }

        const searchUrls = {
          ai_search_csdn: `https://so.csdn.net/so/search?q=${encodeURIComponent(rawQuery)}`,
          ai_search_juejin: `https://juejin.cn/search?query=${encodeURIComponent(rawQuery)}`,
          ai_search_segmentfault: `https://segmentfault.com/search?q=${encodeURIComponent(rawQuery)}`,
          ai_search_cnblogs: `https://zzk.cnblogs.com/s?w=${encodeURIComponent(rawQuery)}`,
          ai_search_oschina: `https://www.oschina.net/search?scope=all&q=${encodeURIComponent(rawQuery)}`,
          ai_search_aliyun_docs: `https://help.aliyun.com/search?spm=a2c4g.11186623.0.0&k=${encodeURIComponent(rawQuery)}`,
          ai_search_tencent_docs: `https://cloud.tencent.com/search?s=doc&keyword=${encodeURIComponent(rawQuery)}`
        };

        const platformInfo = {
          ai_search_csdn: {
            name: 'CSDN',
            icon: '📝',
            description: '中国最大的IT社区和服务平台',
            tips: ['博客文章', '技术问答', '代码片段', '下载资源'],
            homepage: 'https://www.csdn.net/',
            toolKey: 'csdn-search'
          },
          ai_search_juejin: {
            name: '掘金',
            icon: '💎',
            description: '面向开发者的技术内容分享平台',
            tips: ['前端开发', '后端开发', 'Android', 'iOS', '人工智能'],
            homepage: 'https://juejin.cn/',
            toolKey: 'juejin-search'
          },
          ai_search_segmentfault: {
            name: 'SegmentFault',
            icon: '🔧',
            description: '中文技术问答社区',
            tips: ['技术问答', '技术文章', '活动沙龙', '编程挑战'],
            homepage: 'https://segmentfault.com/',
            toolKey: 'sf-search'
          },
          ai_search_cnblogs: {
            name: '博客园',
            icon: '📚',
            description: '开发者的网上家园',
            tips: ['.NET', 'C#', 'Java', 'Python', '数据库'],
            homepage: 'https://www.cnblogs.com/',
            toolKey: 'cnblogs-search'
          },
          ai_search_oschina: {
            name: '开源中国',
            icon: '🌐',
            description: '中国最大的开源技术社区',
            tips: ['开源项目', '技术资讯', '代码托管', '协作翻译'],
            homepage: 'https://www.oschina.net/',
            toolKey: 'oschina-search'
          },
          ai_search_aliyun_docs: {
            name: '阿里云文档',
            icon: '☁️',
            description: '阿里云产品文档中心',
            tips: ['ECS', 'OSS', 'RDS', 'SLB', '容器服务'],
            homepage: 'https://help.aliyun.com/',
            toolKey: 'aliyun-docs'
          },
          ai_search_tencent_docs: {
            name: '腾讯云文档',
            icon: '☁️',
            description: '腾讯云产品文档中心',
            tips: ['CVM', 'COS', 'CDN', 'SCF', '数据库'],
            homepage: 'https://cloud.tencent.com/document/product',
            toolKey: 'tencent-docs'
          }
        };

        const info = platformInfo[name];
        const searchUrl = searchUrls[name];

        const detailsContent = `${info.icon} ${info.name} 搜索\n\n` +
          `**搜索关键词**: ${rawQuery}\n` +
          `**平台介绍**: ${info.description}\n\n` +
          `---\n\n` +
          `🔗 **搜索链接**: ${searchUrl}\n\n` +
          `⚠️ **请使用 WebFetch 工具获取搜索结果**:\n` +
          `\`\`\`javascript\n` +
          `WebFetch({\n` +
          `  url: "${searchUrl}",\n` +
          `  prompt: "提取前10条搜索结果（标题、作者、发布时间、摘要、链接）"\n` +
          `})\n` +
          `\`\`\`\n\n` +
          `---\n\n` +
          `💡 **${info.name} 热门主题**:\n` +
          info.tips.map(tip => `• ${tip}`).join(' | ') +
          `\n\n🏠 **平台首页**: ${info.homepage}\n\n` +
          `📌 **搜索建议**:\n` +
          `• 使用精确关键词获得更好的结果\n` +
          `• 结合多个平台搜索可获得更全面的信息\n` +
          `• 关注文章的发布时间，优先查看最新内容`;

        const filepath = await saveSearchResult(info.toolKey, rawQuery, detailsContent);

        return makeTextResponse(
          `${info.icon} **${info.name}搜索**\n\n` +
          `**关键词**: ${rawQuery}\n` +
          `**搜索链接**: ${searchUrl}\n\n` +
          `✅ 详细信息已保存至: ${filepath || '保存失败'}\n` +
          `💡 使用 WebFetch 工具访问搜索链接获取结果`
        );
      }

      default:
        throw new Error(`Unknown tool: ${name}`);
    }
  } catch (error) {
    return {
      content: [
        {
          type: 'text',
          text: `❌ 错误: ${error instanceof Error ? error.message : String(error)}`,
        },
      ],
      isError: true,
    };
  }
});

Tool Definition Quality

A4.2/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden and does well by disclosing key behavioral traits: it returns CSDN search URLs rather than actual content, and requires a follow-up action with WebFetch tool. This transparency about the tool's limited scope and required workflow is valuable context not available elsewhere.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is perfectly front-loaded with the core purpose, followed by crucial workflow information. Every sentence earns its place: the first establishes what it does, the second provides critical implementation guidance. No wasted words or unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with no annotations and no output schema, the description provides good completeness by explaining the tool's limited scope (returns URLs only) and required follow-up action. However, it doesn't mention potential limitations like rate limits, authentication needs, or result format expectations, which would be helpful given the lack of structured output information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters thoroughly. The description doesn't add any parameter-specific information beyond what's in the schema, maintaining the baseline score of 3. No compensation is needed given the complete schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('搜索CSDN技术博客和问答') and resource ('CSDN搜索'), distinguishing it from sibling tools that search other platforms like GitHub, StackOverflow, or Chinese tech blogs. The emoji and Chinese text add clarity about the Chinese-language focus.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context about when to use this tool (for searching CSDN technical blogs and Q&A) and explicitly mentions the alternative tool ('WebFetch') needed to access actual results. However, it doesn't specify when NOT to use it compared to other sibling search tools targeting different platforms.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adminhuan/smart-search-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server