MCP零基础学习（2）：开发环境配置指南

最新推荐文章于 2025-09-15 21:58:15 发布

原创

最新推荐文章于 2025-09-15 21:58:15 发布 · 924 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#人工智能 #自动化

2025全新实战指南：10分钟搭建跨平台MCP开发环境，兼容Python与Node.js双生态

一、环境准备：跨平台兼容方案

在开始MCP开发前，确保你的系统满足以下条件：

组件	要求	检测命令
操作系统	Windows 10+/macOS 12+/Linux Ubuntu 20.04+	`uname -a`
Python	3.10+（推荐3.12）	`python --version`
Node.js	18.x LTS（必备）	`node -v`
包管理器	UV（替代pip/conda）	`uv --version`
权限	管理员/root权限	`sudo -v` (Linux/macOS)

💡 避坑提示：

Windows用户需启用开发者模式解决长路径问题

macOS需运行 xcode-select --install 安装命令行工具

二、核心工具安装：UV替代传统包管理

1. 安装UV（超高速Python包管理器）

# 一键安装脚本（跨平台）  
curl -LsSf https://astral.sh/uv/install.sh | sh  

# 验证安装  
uv --version  
# 预期输出: uv 0.2.0 (2025-07更新)

2. 配置UV镜像加速（国内用户必做）

# 设置清华镜像源  
uv config set registry.index-url "https://pypi.tuna.tsinghua.edu.cn/simple"  

# 永久生效（写入.zshrc/.bashrc）  
echo 'export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"' >> ~/.zshrc

三、Python环境配置（MCP服务端）

1. 创建隔离虚拟环境

# 新建mcp-dev目录并进入  
mkdir mcp-dev && cd mcp-dev  

# 使用UV创建虚拟环境  
uv venv .venv  

# 激活环境  
# Windows: .\.venv\Scripts\activate  
source .venv/bin/activate  # Linux/macOS

2. 安装MCP核心库

# 安装官方工具包  
uv pip install "fast-mcp>=1.5" mcp-toolkit anthropic-mcp  

# 验证安装  
python -c "from fast_mcp import __version__; print(f'FastMCP v{__version__}')"