网络搜索服务

一个基于Tavily API的MCP服务器,提供网络搜索功能,适用于信息查询和开发集成。

  • by keertanachandar
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 keertanachandar/AIE8-MCP

使用说明

AI创客空间:MCP第13场会议代表

该项目是MCP(模型上下文协议)服务器的演示,该服务器利用Tavily API进行网络搜索功能。服务器设计为在标准输入/输出(stdio)传输模式下运行。

项目概述

MCP服务器设置为使用Tavily API处理网络搜索查询。它由以下关键部件组成:

  • TavilyClient:用于与Tavily API交互以执行网络搜索的客户端。

先决条件

  • Python 3.13或更高版本
  • 有效的Tavily API密钥

⚠️WINDOWS注意事项:⚠️

您需要在 视窗 操作系统的侧面。

这将需要为Powershell获取两个CLI工具,具体操作如下:

  • winget install astral-sh.uv
  • winget install --id Git.Git -e --source winget

拥有这些CLI工具后,请打开Cursor 进入Windows.

然后,您可以在Cursor终端中使用以下命令克隆存储库:

git clone https://AI-Maker-Space/AIE8-MCP-Session.git

之后,您可以从步骤2开始。在......下面

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd <repository-directory>
    
  2. 配置环境变量: 复制 .env.sample 到 .env 并添加您的Tavily API密钥:

    TAVILY_API_KEY=your_tavily_api_key_here
    WEATHER_API_KEY=your_weather_api_key_here
    OPENAI_API_KEY=your_openai_api_key_here
    

    要获取WeatherAPI密钥,请执行以下操作:

    • 访问https://www.weatherapi.com/
    • 注册一个免费帐户(每月提供100万次通话)
    • 从仪表板获取API密钥
  3. 🏗️ 向MCP服务器添加新工具 🏗️

在中创建新工具 server.py 文件,就是这样!

运行MCP服务器

要启动MCP服务器,您需要在Cursor中的MCP配置文件中添加以下内容:

注意:要访问MCP配置。您可以使用命令托盘(CMD/CTRL+SHIFT+P)并选择“查看:打开MCP设置”,然后用下面的JSON blob替换内容。

{
    "mcpServers":  {
        "mcp-server": {
            "command" : "uv",
            "args" : ["--directory", "/PATH/TO/REPOSITORY", "run", "server.py"]
        }
    }
}

服务器将启动并通过标准输入/输出监听命令。

用法

服务器提供 web_search 可用于在网络上搜索给定查询信息的工具。这是通过调用 web_search 使用所需的查询字符串执行函数。

活动:

这项任务有一些活动!

🏗️ 活动#1:

选择您喜欢使用的API,并为其构建MCP服务器!

🏗️ 活动#2:

构建一个与MCP服务器交互的简单LangGraph应用程序。

您可以找到详细信息 这里!

运行LangGraph应用程序

要运行使用MCP服务器的LangGraph应用程序,请执行以下操作:

python3 langgraph_app.py

或者尝试演示版本,查看所有MCP工具的运行情况:

python3 demo_langgraph.py

该应用程序提供了一个交互式命令行界面,您可以在其中:

  • 询问天气:“西雅图的天气怎么样?”
  • 搜索网页:“搜索有关Python的信息”
  • 掷骰子:“掷2d20k1”或“掷骰子”

该应用程序智能地将您的请求路由到适当的MCP工具,并在需要时使用LLM提供响应。

包含内容:

  • langgraph_app.py -具有LLM集成的全交互式LangGraph应用程序
  • demo_langgraph.py -快速演示,显示所有MCP工具协同工作