前言
目前 MCP(Model Context Protocol)协议是给大模型插上工具链的翅膀,让大模型不仅拥有超高的推理和文本生成能力,还能具备执行工具的能力。
如何开发一个 MCP?
MCP 是一种协议,指的是模型上下文协议 (Model Context Protocol)。
官方 SDK: https://github.com/modelcontextprotocol/python-sdk
mcp 库
pip install mcp
我们先来做一个简单的案例:
from mcp.server.fastmcp import FastMCP
import requests
mcp = FastMCP("spider")
@mcp.tool()
def crawl(url: str) -> int:
"""获取网页的源代码"""
response = requests.get(url)
return response.text
if __name__ == "__main__":
mcp.run(transport='stdio') # mcp.run(transport="sse")
以上代码实现了 FastMCP 库来创建一个简单的 MCP 服务器,它提供一个基本的工具(工具名:crawl),用于实现源代码的获取。这是一个非常简单的爬虫 MCP 入门示例,适合理解 MCP 服务器的工作原理和 FastMCP 的基本用法。
代码分析
首先,从 mcp.server.fastmcp 模块中导入了 FastMCP 类。接着,创建了一个 FastMCP 类的实例,命名为 spider。
FastMCP 是服务器的核心类,它负责管理工具、资源和通信。参数「spider」是服务器的名称,用于标识这个 MCP 服务器。
然后,@mcp.tool() 是一个装饰器(decorator),它告诉 FastMCP 将 crawl 函数注册为一个可供客户端调用的工具。
文档字符串("""获取网页的源代码"""):这是函数的描述,客户端(如 MCP Inspector)会显示这个描述,帮助用户理解工具的功能。这个工具可以被外部客户端调用!
例如通过 MCP 协议发送请求,传入 url,服务器会返回它的网页源代码。
mcp.run(transport='stdio') 启动 MCP 服务器,进入监听状态,等待客户端的连接和请求。transport='stdio' 指定了通信方式为标准输入输出(Standard I/O)。这意味着服务器通过命令行的标准输入(stdin)和标准输出(stdout)与客户端通信,适合本地开发和测试。
mcp.run(transport='stdio') 启动 MCP 服务器,如果需要远程通信,可以更改为其他传输方式(如 'sse',Server-Sent Events)。
fastapi-mcp 库
pip install fastapi-mcp
案例分析:
requests
fastapi FastAPI, HTTPException, Query
pydantic BaseModel
typing
fastapi_mcp add_mcp_server
app = FastAPI(
title=,
description=,
version=,
)
() -> :
response = requests.get(url)
{: response.text}
mcp_server = add_mcp_server(
app,
mount_path=,
name=,
description=,
base_url=,
describe_all_responses=,
describe_full_response_schema=,
)
__name__ == :
uvicorn
uvicorn.run(app, host=, port=)








