MCP服务器工具集

一个基于MCP协议的服务器工具集,提供网页搜索、骰子模拟和Notion集成功能,适用于开发者和AI应用场景。

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

使用说明

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

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

项目概述

MCP服务器被设置为处理多种工具,包括网络搜索、掷骰子和Notion集成。它由以下关键部件组成:

  • TavilyClient:用于与Tavily API交互以执行网络搜索的客户端。
  • DiceRoller:使用标准RPG符号掷骰子的实用程序。
  • 概念整合:一个用于向Notion添加注释和摘要并跟踪绩效的工具。

先决条件

  • Python 3.13或更高版本
  • 有效的Tavily API密钥
  • (可选)用于Notion集成的Notion 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_api_key_here
    
  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"]
        }
    }
}

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

用法

服务器提供多种工具:

🔍 网页搜索

使用Tavily API在网络上搜索关于给定查询的信息。

@web_search What are the latest developments in AI?

🎲 摇骰子

使用标准RPG符号掷骰子(例如“2d6”、“1d20+5”)。

@roll_dice notation="2d6" num_rolls=3

📝 概念整合

在Notion中添加注释和摘要,并进行详细的绩效跟踪。

@add_to_notion Add a note titled "Meeting Notes" with today's discussion points

有关Notion设置的详细说明,请参阅 NOTION_SETUP.md

活动:

这项任务有一些活动!

🏗️ 活动#1:

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

🏗️ 活动#2:

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

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