极客前沿

AI 入门:用 Python MCP 让大模型连接你的数据

2026-05-27 01:30
Real Python
查看原文

零基础学会安装 MCP 协议,用 Python 写一个服务器,让 AI 读取你的数据库。

什么是 MCP?为什么你需要它?

MCP(模型上下文协议)是一种新协议,让 AI 模型能安全地访问你的本地数据或外部系统。简单说,它就像 AI 的“USB 接口”——插上就能读取数据库、文件等资源。本教程带你从零安装并跑通第一个 MCP 服务器。

Tutorial Image

准备环境:装好 Python 和编辑器

  • 安装 Python 3.10+:去 python.org 下载,安装时勾选“Add Python to PATH”。
  • 安装 Cursor(或任何支持 MCP 的 AI 编辑器):cursor.com 下载免费版。
  • 打开终端(Win 按 Win+R 输入 cmd;Mac 打开“终端”APP),输入 python --version 确认版本。

安装 MCP 并创建你的第一个服务器

  1. 在终端运行 pip install mcp 安装 MCP 库。
  2. 创建一个文件夹,例如 mcp_demo,在里面新建文件 server.py
  3. 复制以下代码到 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())
  4. 保存文件,在终端运行 python server.py。如果看到“运行中”无报错,说明成功。

在 Cursor 中连接你的 MCP 服务器

  1. 打开 Cursor,点击左下角设置图标 → MCP 配置
  2. 添加新服务器:名称随意,命令填 python /你的完整路径/server.py
  3. 点击“连接”,状态显示绿色即成功。现在 AI 可以调用你的服务器了!

常见坑与下一步

  • 坑:路径不要有中文或空格;如果报错“找不到模块”,先执行 pip install mcp 确认安装。
  • 下一步:在服务器中添加真正的工具(比如查询数据库),让 AI 回答“上个月销量最高的商品”等问题。

内容来源

Real Python

发布时间

2026-05-27 01:30

返回 AI技术