第一部分:MCP协议基础与实践

第3期 从零开始创建MCP服务器:Python实现指南

1.3 从零开始创建MCP服务器:Python实现指南

本节将详细介绍如何使用Python创建自己的MCP服务器,让您能够为AI模型提供自定义功能。通过官方的Python SDK,您可以轻松构建支持资源、提示和工具的服务器。

安装MCP Python SDK

首先,您需要安装MCP Python SDK,它提供了构建服务器所需的工具。您可以使用pip进行安装:

pip install mcp

或者,如果您使用uv工具(Claude Desktop推荐),请运行:

uv add "mcp[cli]"

在macOS上,可以通过brew install uv安装uv工具。

创建基本的MCP服务器

要创建服务器,您将使用SDK中的FastMCP类。以下是创建步骤:

  1. 定义服务器:创建一个Python脚本,例如server.py,导入FastMCP并为服务器命名:

    from mcp import FastMCP
    mcp = FastMCP("My First Server")
    
  2. 添加工具:工具是LLM可以调用的函数,使用@mcp.tool()定义。例如,一个加法工具:

    @mcp.tool()
    def add(a: int, b: int) -> int:
        """Add two numbers"""    return a + b
    
  3. 添加资源:资源提供数据,使用@mcp.resource()定义。例如,一个问候资源:

    @mcp.resource("greeting")
    def get_greeting(name: str) -> str:
        return f"Hello, {name}!"
    

运行和测试服务器

实例一:当前时间服务器(资源)

这个服务器提供一个返回当前日期和时间的资源。