金大哥 - websearch MCP 详情

article

README

🚀 网络搜索指南

WebSearch MCP服务器是一款用于执行网络搜索的工具，支持多语言搜索、区域限制、排除特定域名等高级功能，能为用户提供精准、高效的搜索服务。以下是详细的使用指南。

🚀 快速开始

使用Docker运行服务

您可以使用以下命令快速启动WebSearch MCP服务器：

docker-compose up --build

此命令会构建并运行所有必要的容器，包括WebSearch服务和FlareSolverr（用于处理反垃圾验证）。

手动安装

克隆仓库：

git clone <repository-url>
cd websearch-mcp-server

安装依赖项：

npm install

启动开发模式：

npm run dev

✨ 主要特性

多语言支持：根据指定的语言返回搜索结果。
区域限制：可以根据地区代码过滤结果。
排除域名：指定要排除的域名，避免显示特定网站的内容。
多种结果类型：支持“all”、“news”和“blogs”三种结果类型。

示例响应

{
  "query": "机器学习趋势",
  "results": [
    {
      "title": "2025年人工智能发展趋势",
      "snippet": "2025年关键的人工智能趋势包括多模态AI、生成模型和量子人工智能在企业中的应用...",
      "url": "https://example.com/ml-trends-2025",
      "siteName": "人工智能研究今日",
      "byline": "简·史密斯博士"
    },
    {
      "title": "机器学习五年演变历程：2020-2025",
      "snippet": "过去五年，机器学习从监督学习方法发展到更复杂的自监督和强化学习范式...",
      "url": "https://example.com/ml-evolution",
      "siteName": "科技洞察",
      "byline": "约翰·多伊"
    }
  ]
}

💻 使用示例

作为命令行工具

运行以下命令启动MCP服务器：

npm run start

然后使用提供的测试客户端与服务器交互：

npm run test-client

作为库

您可以将此包程序化地使用：

import { createMCPClient } from '@modelcontextprotocol/sdk';

// 创建MCP客户端
const client = createMCPClient({
  transport: { type: 'subprocess', command: 'npx websearch-mcp' }
});

// 执行网络搜索
const response = await client.request({
  method: 'call_tool',
  params: {
    name: 'web_search',
    arguments: {
      query: '您的搜索词',
      numResults: 5,
      language: 'zh'
    }
  }
});

console.log(response.result);

🔧 技术细节

故障排除

网络搜索服务问题

错误信息：检查是否有任何错误日志输出。
反垃圾验证：确保FlareSolverr正常运行。

开发问题

依赖项缺失：如果安装失败，请重新运行npm install。
构建失败：检查项目中的package.json文件是否完整。

项目结构

websearch-mcp-server/
├── src/                 # 源代码目录
│   ├── index.js       # 入口文件
│   └── server.js      # 服务器配置
├── package.json       # 依赖项和脚本
└── docker-compose.yml # Docker配置文件

发布npm包

更新package.json中的版本号。
提交更改：

git add .
git commit -m "更新版本"

打包并发布：

npm pack
npm publish

🤝 贡献指南

请 fork 仓库并在您的分支上进行开发。
提交Pull Request前，请确保代码通过所有测试。

感谢使用WebSearch MCP服务器！如果有任何问题，请随时联系维护团队。

websearch