当测试工程师初次接触 MCP Server 时,可能会面临许多挑战,尤其是搭建 Python 新版本环境的过程中。本文将从零开始,带你一步步构建一个 MCP Server 示例项目,并解决 Python 3.12 中废弃 distutils
模块的问题,让你的开发环境更加稳定,工程更易上手。
一、背景与目标
MCP(Micro Communication Protocol)是一个轻量级协议,适用于服务间的快速通信。作为测试工程师,我们在构建 MCP Server 时,需要一个适配项目需求的 Python 虚拟环境。Python 3.12 是一个较新的版本,但它废弃了 distutils
模块,这对安装一些依赖库造成了阻碍。
本文目标:
- 配置基于 Python 3.12 的虚拟环境。
- 快速解决
distutils
模块的问题。 - 创建一个 MCP Server 示例项目,验证环境是否配置成功。
二、安装 Python 多版本管理工具
在实际开发中,我们可能需要在不同的项目中使用不同版本的 Python 环境。这里推荐使用 uv(Universal Virtualenv Manager),它是一个轻量级的 Python 多版本管理工具,支持快速创建虚拟环境。
1. 安装 uv
首先,安装 uv
工具:
pip install uv
安装完成后,输入 uv --help
检查是否安装成功。
2. 创建 Python 3.12 虚拟环境
切换到指定项目目录,在该目录下创建基于 Python 3.12 的虚拟环境:
uv venv --python 3.12.0
这条命令会自动下载 Python 3.12.0,并创建一个虚拟环境。
3. 配置虚拟环境到 PyCharm
接下来,我们需要在 PyCharm 中设置项目的解释器为刚刚创建的虚拟环境:
- 打开 PyCharm,创建一个新的工程。
- 在 PyCharm 的设置中,找到 Python Int