AI 入门:用 Python MCP 让大模型连接你的数据
零基础学会安装 MCP 协议,用 Python 写一个服务器,让 AI 读取你的数据库。
什么是 MCP?为什么你需要它?
MCP(模型上下文协议)是一种新协议,让 AI 模型能安全地访问你的本地数据或外部系统。简单说,它就像 AI 的“USB 接口”——插上就能读取数据库、文件等资源。本教程带你从零安装并跑通第一个 MCP 服务器。
准备环境:装好 Python 和编辑器
- 安装 Python 3.10+:去 python.org 下载,安装时勾选“Add Python to PATH”。
- 安装 Cursor(或任何支持 MCP 的 AI 编辑器):cursor.com 下载免费版。
- 打开终端(Win 按 Win+R 输入 cmd;Mac 打开“终端”APP),输入
python --version确认版本。
安装 MCP 并创建你的第一个服务器
- 在终端运行
pip install mcp安装 MCP 库。 - 创建一个文件夹,例如
mcp_demo,在里面新建文件server.py。 - 复制以下代码到
server.py:from mcp.server import Server, NotificationOptions
from mcp.server.models import InitializationOptions
import mcp.server.stdio
server = Server("ecommerce-server")
@server.list_prompts()
async def handle_list_prompts():
return []
@server.list_resources()
async def handle_list_resources():
return []
@server.list_tools()
async def handle_list_tools():
return []
async def run():
async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
await server.run(read_stream, write_stream, InitializationOptions(server_name="ecommerce-server"))
if __name__ == "__main__":
import asyncio
asyncio.run(run()) - 保存文件,在终端运行
python server.py。如果看到“运行中”无报错,说明成功。
在 Cursor 中连接你的 MCP 服务器
- 打开 Cursor,点击左下角设置图标 → MCP 配置。
- 添加新服务器:名称随意,命令填
python /你的完整路径/server.py。 - 点击“连接”,状态显示绿色即成功。现在 AI 可以调用你的服务器了!
常见坑与下一步
- 坑:路径不要有中文或空格;如果报错“找不到模块”,先执行
pip install mcp确认安装。 - 下一步:在服务器中添加真正的工具(比如查询数据库),让 AI 回答“上个月销量最高的商品”等问题。
内容来源
Real Python
发布时间
2026-05-27 01:30