极客前沿

AI 入门:装好 Python 环境,跑通你的第一个 MCP 服务

2026-08-04 01:30
Real Python
查看原文

零基础也能学会:一步步安装 Python 和 MCP 库,跑通第一个 MCP 服务,并了解新版本的变化。

最近,AI 圈子有一个大新闻:连接 AI 助手和你电脑上各种工具的协议 MCP 迎来了史上最大更新。如果你刚接触 AI,可能还不知道 MCP 是什么,没关系,这篇文章会带你一步步安装好环境,跑通第一个 MCP 服务,让你亲眼看到 AI 是怎么调用工具的。

Tutorial Image

准备环境:先装好 Python

MCP 是用 Python 写的,所以第一步是安装 Python。Python 是一种编程语言,很多 AI 工具都用它开发。

Tutorial Image
  • 去 Python 官网 python.org(Python 的官方下载网站)下载最新版 Python,推荐 3.12 或更高版本。
  • 安装时记得勾选“Add Python to PATH”(把 Python 添加到系统路径),这样在命令行里才能直接使用 python 命令。
  • 安装完成后,打开终端(Windows 用命令提示符,Mac 用“终端”应用),输入 python --version,如果显示版本号,说明安装成功。

安装步骤:装 MCP 库

MCP 是一个协议,它让 AI 助手(比如 ChatGPT)能安全地调用你电脑上的工具。我们要用 Python 的 包管理器 pip(Python 自带的安装工具)来安装 MCP 的官方库。

Tutorial Image
  1. 在终端里输入 pip install mcp,回车。这会自动下载并安装 MCP 库。
  2. 如果你之前装过旧版本,升级到最新版:pip install --upgrade mcp
  3. 安装完成后,输入 pip show mcp 查看版本,确保是 2.0 或更高。

验证是否成功:跑通第一个 MCP 服务

为了确认安装成功,我们来创建一个最简单的 MCP 服务。MCP 服务就是一个让 AI 能调用的工具。

Tutorial Image
  1. 新建一个文件夹,比如叫 mcp-test,在里面新建一个文件 server.py
  2. 用记事本打开 server.py,输入以下代码:
from mcp import MCPServer

server = MCPServer("hello")

@server.tool()
def greet(name: str) -> str:
    return f"你好,{name}!"

if __name__ == "__main__":
    server.run()

这段代码创建了一个叫 hello 的服务,里面有一个 greet 工具,输入名字,就会返回问候语。

  1. 在终端里,进入 mcp-test 文件夹,运行 python server.py。如果看到类似“Server running”的提示,说明你的第一个 MCP 服务已经跑通了!

注意:如果你之前用过旧版的 FastMCP 类,现在新版本改名为 MCPServer,旧代码需要改一下。

下一步可以做什么

恭喜你,你已经迈出了 AI 开发的第一步!接下来,你可以尝试:

  • server.py 里添加更多工具,让 AI 能调用你的电脑文件、计算器等。
  • 学习如何连接你的服务到 AI 助手,比如配置 ChatGPT 的 MCP 客户端。
  • 看看官方文档,了解 MCP 的新特性,比如无状态设计、安全增强等。

记住,遇到问题不要怕,多搜索、多尝试。祝你玩得开心!

内容来源

Real Python

发布时间

2026-08-04 01:30

返回 AI技术