🚀 网络搜索指南
WebSearch MCP服务器是一款用于执行网络搜索的工具，支持多语言搜索、区域限制、排除特定域名等高级功能，能为用户提供精准、高效的搜索服务。以下是详细的使用指南。
🚀 快速开始
使用Docker运行服务
您可以使用以下命令快速启动WebSearch MCP服务器：
docker-compose up --build
此命令会构建并运行所有必要的容器，包括WebSearch服务和FlareSolverr（用于处理反垃圾验证）。
手动安装
- 克隆仓库：
git clone
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服务器！如果有任何问题，请随时联系维护团队。