DataWhale 速通AI编程开发：（进阶篇）第4章 MCP服务

MCP（Model Context Protocol）是模型上下文协议的简称，它是一种允许Roo Code与本地运行的MCP服务器进行通信的协议。这些服务器提供额外的工具和资源，可以显著扩展Roo Code的功能。功能扩展：添加Roo Code原生不支持的新功能数据整合：将外部数据源与Roo Code连接自定义工具：创建适合特定工作流程的专用工具在第2章中，我们简单提到过MCP服务是Roo Cod

crazy_god

926人浏览 · 2025-03-16 14:11:20

crazy_god · 2025-03-16 14:11:20 发布

学习地址：Datawhale-学用 AI,从此开始

（进阶篇）第4章 MCP服务

4.1 什么是MCP服务

MCP（Model Context Protocol）是模型上下文协议的简称，它是一种允许Roo Code与本地运行的MCP服务器进行通信的协议。这些服务器提供额外的工具和资源，可以显著扩展Roo Code的功能。通过MCP服务，我们可以实现：

功能扩展：添加Roo Code原生不支持的新功能
数据整合：将外部数据源与Roo Code连接
自定义工具：创建适合特定工作流程的专用工具

在第2章中，我们简单提到过MCP服务是Roo Code菜单栏的一部分，现在让我们深入了解它的工作原理和实际应用。

MCP服务菜单

4.2 MCP服务的工作原理

为方便阐述MCP服务的工作原理，这里引用一个场景，用户要通过外部程序向其他人打招呼：

服务注册：用户在本地启动MCP服务器，并在Roo Code中注册向其他人打招呼的服务,这个步骤其实是同时进行的
功能暴露：MCP服务器向Roo Code暴露一系列工具和功能
用户请求: 用户向大语言模型发送一个请求，例如“请向学习者打招呼”。
模型判断: 大语言模型分析用户请求，判断它是否需要外部工具。如果需要，例如需要向学习者打招呼，它会生成一个包含工具名称和参数的 JSON 对象。
工具调用: Roo Code 接收到这个 JSON 对象，并调用相应的工具。
工具响应: 工具执行操作，并将结果返回给 Roo Code。例如，打招呼 API 返回确认执行的信息。
模型响应: Roo Code 利用工具返回的信息，生成最终的、用户友好的回复。例如，“Hello 学习者!”

整个过程如下图所示：

MCP服务工作流程

从技术角度看，MCP服务实际上是一个遵循特定协议的服务器，它与Roo Code进行通信，提供各种功能接口。

4.3 使用python创建一个MCP服务

4.3.1 准备工作

创建MCP服务需要一定的编程基础，通常我们会使用Node.js或Python来构建服务。在开始前，请确保：

已安装Node.js或Python
了解基本的HTTP服务器概念
有一定的JavaScript或Python编程经验

我们这里演示使用python创建一个简单的mcp服务，功能是用于打招呼。

4.3.2 使用Python创建简单的MCP服务

首先创建一个新的项目文件夹，并安装mcp：

mkdir python-mcp-server
cd python-mcp-server
pip install mcp

创建一个main.py文件，内容如下：

# 导入必要的模块
import logging
from mcp.server.fastmcp import FastMCP

# 设置日志配置
logging.basicConfig(
    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)
logger = logging.getLogger(__name__)


class HelloService:
    """一个简单的 MCP 问候服务

    这个服务提供一个基础的问候工具，可以根据提供的名字返回问候语。
    它展示了如何创建一个基本的 MCP 服务器并注册工具。
    """

    def __init__(self):
        # 创建一个 FastMCP 服务器实例
        # FastMCP 是 MCP 的高级抽象，它简化了服务器的创建和管理
        self.server = FastMCP("hello-service")

        # 使用装饰器注册工具
        # FastMCP 会自动从函数签名和文档字符串中提取工具的描述和参数信息
        @self.server.tool()
        async def greet(name: str = "World") -> str:
            """基础问候服务

            Args:
                name (str): 要问候的名字，默认为 "World"

            Returns:
                str: 问候语
            """
            logger.info(f"收到问候请求，name: {name}")
            result = f"Hello {name}!"
            logger.info(f"返回结果: {result}")
            return result

    def run(self):
        """运行服务器

        这个方法启动 MCP 服务器并处理来自客户端的请求。
        服务器会一直运行，直到发生错误或被手动停止。
        """
        try:
            logger.info("✅ MCP服务启动中...")
            logger.info("服务名称: hello-service")
            logger.info("等待连接...")
            # FastMCP 的 run 方法会自动处理:
            # - 服务器初始化
            # - 连接管理
            # - 请求处理
            # - 错误处理
            self.server.run()
        except Exception as e:
            logger.error(f"❌ 服务异常: {str(e)}")
            raise


if __name__ == "__main__":
    # 创建服务实例并运行
    service = HelloService()
    service.run()

运行服务器：

python app.py

至此，这个Python版本的MCP服务提供了一个简单的打招呼工具，用于演示目的。

4.4 添加MCP服务

我们可以通过以下步骤添加现有的MCP服务：

点击Roo Code菜单栏中的"MCP Servers"
启用"Enable MCP Servers"和"Enable MCP Server Creation"
点击"Edit MCP Settings"，会出现一个json文件
编辑cline_mcp_settings.json文件，这里给出我的配置文件，并且解释每个配置项的含义(由于json中不允许出现注释，因此大家在实际编辑文件中，请去掉注释)：

{
  "mcpServers": {
    "hello": // 添加的mcp服务名称
    { 
      "command": "/Users/michaelbradley/Documents/Cline/MCP/print/.conda/bin/python", // 由于mcp服务调用python运行，这里添加python的绝对路径
      "args": [
        "/Users/michaelbradley/Documents/Cline/MCP/print/main.py"
      ], // mcp服务的main.py的绝对路径
      "cwd": "/Users/michaelbradley/Documents/Cline/MCP/print" // mcp服务项目的绝对路径
    }
  }
}

保存后cline_mcp_settings.json文件，Roo Code会自动连接并启用该服务。

注：上述代码及教程，是苹果本的配置方式，以下为win11的配置方式

{
  "mcpServers": {
    "hello": {
      "command": "D:/ProgramFiles/anaconda3/python.exe",
      "args": [
        "E:/PycharmProjects/MCP/main.py"
      ],
      "cwd": "E:/PycharmProjects/MCP/",
      "env": {}
    }
  }
}

MCP服务添加成功