AI搜索与页面访问工具 MCP Server

基于智谱AI的网页搜索与网页阅读API接口，提供联网搜索和页面内容访问功能。

功能特点

• 联网搜索：使用智谱AI搜索API，根据关键词返回相关网页搜索结果
• 页面访问：使用智谱AI页面阅读API，获取指定URL的页面内容
• MCP协议支持：符合MCP协议的工具服务，可与支持MCP的客户端集成
• StreamableHTTP模式：基于FastAPI构建，支持流式HTTP请求

安装依赖

pip install -r requirements.txt

配置

1. 复制 .env.example 文件为 .env
2. 在 .env 文件中配置智谱AI API密钥：

ZHIPU_AI_API_KEY=your_api_key_here

启动服务

python server.py

服务将在 http://0.0.0.0:52225 启动。

服务端点

• 根路径：/ - MCP协议入口
• 工具列表：/tools - 列出所有可用工具
• 工具调用：/tools/call - 调用具体工具
• 健康检查：/health - 检查服务状态

可用工具

1. web_search

根据搜索查询返回搜索结果的列表。

参数：

• search_query (string)：搜索查询字符串

返回：

• 包含搜索结果的列表，每个元素是一个字典，包含标题、URL和内容

2. visit_pages

根据页面URL返回页面内容。

参数：

• page_url (string)：请求页面的URL地址

返回：

• 包含页面内容的JSON数据

使用示例

使用curl调用web_search工具

curl -X POST -H "Content-Type: application/json" \
  -d '{"name": "web_search", "arguments": {"search_query": "svm支持向量机"}}' \
  http://localhost:52225/tools/call

使用curl调用visit_pages工具

curl -X POST -H "Content-Type: application/json" \
  -d '{"name": "visit_pages", "arguments": {"page_url": "https://example.com"}}' \
  http://localhost:52225/tools/call

MCP协议支持

该服务符合MCP协议，可通过MCP客户端进行调用。支持的MCP方法：

• initialize：初始化连接
• tools/list：列出可用工具
• tools/call：调用工具

测试

运行测试客户端：

python test_client.py

技术栈

• Python 3.8+
• FastAPI
• Requests
• python-dotenv
• Uvicorn

许可证

MIT