Web Search
What is Web Search
Web-search is a Model Context Protocol (MCP) server that provides network search functionalities using the Zhipu AI search API.
Use cases
Use cases for web-search include integrating search functionalities into applications, conducting data retrieval for research, and enhancing user experience in web platforms by providing quick search results.
How to use
To use web-search, install Python 3.10 or higher, configure the environment variables in the .env file with your API key, install the required dependencies listed in pyproject.toml, and run the server using ‘uv run main.py’.
Key features
Key features include asynchronous network search interface, error handling and result parsing, environment variable configuration for API keys, and standard input/output support.
Where to use
Web-search can be utilized in various fields such as web applications, data analysis, research tools, and any application requiring efficient search capabilities.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Web Search
Web-search is a Model Context Protocol (MCP) server that provides network search functionalities using the Zhipu AI search API.
Use cases
Use cases for web-search include integrating search functionalities into applications, conducting data retrieval for research, and enhancing user experience in web platforms by providing quick search results.
How to use
To use web-search, install Python 3.10 or higher, configure the environment variables in the .env file with your API key, install the required dependencies listed in pyproject.toml, and run the server using ‘uv run main.py’.
Key features
Key features include asynchronous network search interface, error handling and result parsing, environment variable configuration for API keys, and standard input/output support.
Where to use
Web-search can be utilized in various fields such as web applications, data analysis, research tools, and any application requiring efficient search capabilities.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Web Search MCP 服务器
这是一个基于 MCP（Model Context Protocol）实现的网络搜索服务器，提供了网络搜索功能的工具接口。
项目功能
项目主要提供了一个网络搜索工具，通过调用智谱 AI 的搜索 API 实现搜索功能。主要特点：
- 提供异步网络搜索接口
- 支持错误处理和结果解析
- 使用环境变量配置 API 密钥
- 支持标准输入输出（stdio）作为传输方式
技术栈
- Python >= 3.10
- 主要依赖：
- httpx: 用于异步 HTTP 请求
- mcp[cli]: MCP 服务器实现
- python-dotenv: 环境变量管理
项目结构
. ├── main.py # 主程序文件，包含 MCP 服务器实现 ├── pyproject.toml # 项目配置和依赖管理 ├── .env # 环境变量配置文件 └── README.md # 项目文档
主要组件
MCP 服务器（main.py）
实现了一个名为 web-search-server 的 FastMCP 服务器，提供以下功能：
web_search工具：- 接收搜索查询字符串
- 调用智谱 AI 的搜索 API
- 处理 API 响应并返回搜索结果
- 支持错误处理
配置文件
pyproject.toml: 定义项目元数据和依赖.env: 存储 API 密钥配置
使用方法
- 确保已安装 Python 3.10 或更高版本
- 配置环境变量：在
.env文件中设置BIGMODEL_API_KEY - 安装依赖：使用包管理器安装
pyproject.toml中列出的依赖 - 运行服务器：执行
uv run main.py
开发指南
开发环境设置
- 创建并激活 Python 虚拟环境
uv venv && source .venv/bin/activate # Unix/macOS
# 或
.venv\Scripts\activate # Windows
- 安装开发依赖
uv sync # 以可编辑模式安装项目
调试方法
- 使用 mcp 调试
mcp dev main.py
- 使用 inspector 调试
npx -y @modelcontextprotocol/inspector uv run main.py
开发工作流程
-
代码修改
- 遵循异步编程模式
- 使用类型注解增强代码可读性
- 保持错误处理的完整性
-
测试验证
- 运行测试功能验证改动
- 检查 API 响应处理
- 验证错误处理机制
-
错误处理最佳实践
- API 调用错误：检查 response 中的 error 字段
- 网络错误：使用 try-except 捕获 httpx 异常
- 参数验证：确保查询字符串不为空
-
性能优化建议
- 使用 httpx.AsyncClient 的上下文管理器
- 适当处理并发请求
- 考虑添加响应缓存机制
常见问题排查
-
API 密钥问题
- 检查 .env 文件是否存在
- 验证 BIGMODEL_API_KEY 是否正确设置
- 确认环境变量是否正确加载
-
网络请求问题
- 检查网络连接
- 验证 API 请求 URL 是否正确
- 查看请求头和参数格式
-
结果解析问题
- 检查 API 响应格式是否符合预期
- 验证 JSON 解析是否正确
- 确认结果提取逻辑是否正确
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
