MCP网络搜索服务器

基于Tavily API的MCP网络搜索服务器,提供网页搜索、加密货币价格查询和骰子模拟功能,适用于开发者和技术爱好者。

  • by Swathi3255
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Swathi3255/13-MCP-session

使用说明

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

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

项目概述

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

  • 塔维利客户端:用于与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 文件,并添加您的API密钥:

    TAVILY_API_KEY=your_api_key_here
    COINGECKO_API_KEY=your_coingecko_api_key_here  # Optional - free tier works without key but has rate limits
    

    注:CoinGecko API可以在没有API密钥的情况下工作,但使用它提供了更高的速率限制(10-50次呼叫/分钟,带有免费层)。

  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:使用Tavily API在web上搜索有关给定查询的信息
  • roll_dice:用标准符号掷骰子(例如,“2d20k1”表示2个二十面骰子,保持最高1)
  • get_crypto_price:从CoinGecko API获取当前加密货币价格和市场数据(例如,“比特币”、“以太坊”)

活动:

这项任务有一些活动!

🏗️ 活动#1:

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

🏗️ 活动#2:

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

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