Skip to content

3.1 系统要求

🎯 学习目标:了解MCP开发所需的系统环境和硬件要求
⏱️ 预计时间:20分钟
📊 难度等级:⭐

💻 硬件要求

🖥️ 最低配置要求

对于MCP基础开发和学习,你的系统需要满足以下最低要求:

组件最低要求推荐配置说明
CPU双核 2.0GHz四核 3.0GHz+用于运行AI模型和并发处理
内存4GB RAM8GB+ RAMMCP服务器和客户端会占用一定内存
存储2GB 可用空间10GB+ SSD存储开发工具、依赖包和示例代码
网络宽带连接稳定宽带下载依赖包和访问在线AI服务

🚀 生产环境推荐配置

如果你计划部署到生产环境,建议使用更高的配置:

🏢 生产环境配置建议
━━━━━━━━━━━━━━━━━━━━━━━━━
CPU: 8核+ (支持高并发请求)  
内存: 16GB+ (缓存和多进程)
存储: 50GB+ SSD (日志和数据)
网络: 千兆网络 (低延迟通信)

🖱️ 操作系统支持

✅ 完全支持的系统

MCP在以下操作系统上经过充分测试:

🐧 Linux

bash
# 推荐发行版
- Ubuntu 20.04+ LTS  ⭐⭐⭐⭐⭐
- CentOS 8+          ⭐⭐⭐⭐
- Debian 11+         ⭐⭐⭐⭐⭐
- Fedora 35+         ⭐⭐⭐⭐
- Alpine Linux 3.15+ ⭐⭐⭐

# 检查系统版本
cat /etc/os-release

🍎 macOS

bash
# 支持版本
- macOS 12.0 (Monterey)+  ⭐⭐⭐⭐⭐
- macOS 11.0 (Big Sur)+   ⭐⭐⭐⭐

# 检查系统版本
sw_vers

🪟 Windows

powershell
# 支持版本
- Windows 11           ⭐⭐⭐⭐⭐
- Windows 10 (1809+)   ⭐⭐⭐⭐
- Windows Server 2019+ ⭐⭐⭐⭐

# 检查系统版本
winver
# 或者
Get-ComputerInfo | Select WindowsProductName, WindowsVersion

🤔 选择建议

初学者推荐:

  • 🥇 Ubuntu 22.04 LTS - 最友好的开发环境
  • 🥈 macOS 最新版 - 优秀的开发体验
  • 🥉 Windows 11 - WSL2支持良好

生产环境推荐:

  • 🏆 Ubuntu Server 22.04 LTS - 稳定可靠
  • 🏆 CentOS Stream 9 - 企业级选择

🛠️ 开发环境要求

📝 必需的开发工具

1. 代码编辑器/IDE

工具特点适用场景推荐指数
VS Code轻量、插件丰富、MCP支持好全栈开发⭐⭐⭐⭐⭐
WebStorm/IntelliJ功能强大、智能提示企业开发⭐⭐⭐⭐
Sublime Text轻量快速简单编辑⭐⭐⭐
Vim/Neovim高效编辑命令行开发⭐⭐⭐

VS Code推荐插件:

json
{
    "recommendations": [
        "ms-python.python",           // Python支持
        "ms-vscode.vscode-typescript", // TypeScript支持
        "ms-vscode.vscode-json",      // JSON格式化
        "humao.rest-client",          // REST API测试
        "ms-vscode.vscode-mcp"        // MCP官方插件(预计)
    ]
}

2. 版本控制

bash
# Git (必需)
git --version
# 应该显示 2.25.0 或更高版本

# 推荐配置
git config --global user.name "你的姓名"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

3. 终端工具

Linux/macOS:

bash
# 推荐终端
- Terminal (默认)     ⭐⭐⭐
- iTerm2 (macOS)      ⭐⭐⭐⭐⭐  
- Alacritty           ⭐⭐⭐⭐
- Kitty               ⭐⭐⭐⭐

Windows:

powershell
# 推荐终端
- Windows Terminal    ⭐⭐⭐⭐⭐
- PowerShell 7+       ⭐⭐⭐⭐
- WSL2 + zsh          ⭐⭐⭐⭐⭐
- Git Bash            ⭐⭐⭐

🌐 网络和服务要求

🔗 网络连接

必需的网络访问

📡 必需访问的服务
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ npm registry (npmjs.com)        - Node.js包管理
✅ PyPI (pypi.org)                 - Python包管理  
✅ GitHub (github.com)             - 代码仓库
✅ MCP官方文档 (modelcontextprotocol.io) - 文档和规范
✅ AI服务提供商 (如openai.com)      - AI模型API

网络配置检查

bash
# 检查网络连通性
ping -c 4 github.com
ping -c 4 npmjs.com
ping -c 4 pypi.org

# 检查DNS解析
nslookup modelcontextprotocol.io

# 检查HTTP/HTTPS访问
curl -I https://api.github.com

🔐 防火墙和代理

如果你在企业网络环境中,可能需要配置代理:

bash
# NPM代理配置
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# Git代理配置
git config --global http.proxy http://proxy.company.com:8080
git config --global https.proxy http://proxy.company.com:8080

# 环境变量代理
export http_proxy=http://proxy.company.com:8080
export https_proxy=http://proxy.company.com:8080

🐳 容器化环境(可选)

📦 Docker支持

如果你熟悉Docker,可以使用容器化环境:

dockerfile
# MCP开发环境Dockerfile示例
FROM ubuntu:22.04

# 安装基础工具
RUN apt-get update && apt-get install -y \
    curl \
    git \
    vim \
    wget \
    software-properties-common

# 安装Node.js
RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
RUN apt-get install -y nodejs

# 安装Python
RUN apt-get install -y python3 python3-pip python3-venv

# 创建工作目录
WORKDIR /workspace

# 安装常用工具
RUN npm install -g @modelcontextprotocol/sdk
RUN pip3 install mcp-toolkit

CMD ["bash"]

使用方式:

bash
# 构建镜像
docker build -t mcp-dev .

# 运行容器
docker run -it -v $(pwd):/workspace mcp-dev

# 或使用预构建镜像(假设有的话)
docker run -it mcpfoundation/mcp-dev:latest

✅ 系统兼容性检查

🔍 自动检查脚本

创建一个简单的系统检查脚本:

bash
#!/bin/bash
# check-system.sh - MCP系统要求检查脚本

echo "🔍 MCP系统要求检查"
echo "===================="

# 检查操作系统
echo "📋 操作系统:"
if [[ "$OSTYPE" == "linux-gnu"* ]]; then
    echo "✅ Linux - $(lsb_release -d | cut -f2)"
elif [[ "$OSTYPE" == "darwin"* ]]; then
    echo "✅ macOS - $(sw_vers -productVersion)"
elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]]; then
    echo "✅ Windows (通过Git Bash/WSL)"
else
    echo "⚠️  未知操作系统: $OSTYPE"
fi

# 检查内存
echo "💾 内存:"
if command -v free &> /dev/null; then
    total_mem=$(free -m | awk 'NR==2{printf "%.1f", $2/1024}')
    echo "✅ 总内存: ${total_mem}GB"
elif command -v vm_stat &> /dev/null; then
    # macOS内存检查
    echo "✅ macOS内存检查需要手动确认"
fi

# 检查磁盘空间
echo "💿 磁盘空间:"
available_space=$(df -h . | awk 'NR==2 {print $4}')
echo "✅ 可用空间: $available_space"

# 检查网络连接
echo "🌐 网络连接:"
if ping -c 1 github.com &> /dev/null; then
    echo "✅ GitHub连接正常"
else
    echo "❌ GitHub连接失败"
fi

if ping -c 1 npmjs.com &> /dev/null; then
    echo "✅ NPM连接正常"
else
    echo "❌ NPM连接失败"
fi

echo "===================="
echo "✅ 系统检查完成"

🪟 Windows PowerShell版本

powershell
# check-system.ps1 - Windows系统检查脚本

Write-Host "🔍 MCP系统要求检查" -ForegroundColor Green
Write-Host "===================="

# 检查Windows版本
$version = [System.Environment]::OSVersion.Version
Write-Host "📋 操作系统: Windows $($version.Major).$($version.Minor)" -ForegroundColor Green

# 检查内存
$memory = Get-CimInstance -ClassName Win32_ComputerSystem
$totalMemGB = [math]::Round($memory.TotalPhysicalMemory / 1GB, 1)
Write-Host "💾 总内存: $totalMemGB GB" -ForegroundColor Green

# 检查磁盘空间
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceID='C:'"
$freeSpaceGB = [math]::Round($disk.FreeSpace / 1GB, 1)
Write-Host "💿 C盘可用空间: $freeSpaceGB GB" -ForegroundColor Green

# 检查网络连接
Write-Host "🌐 网络连接:" -ForegroundColor Yellow
if (Test-Connection -ComputerName "github.com" -Count 1 -Quiet) {
    Write-Host "✅ GitHub连接正常" -ForegroundColor Green
} else {
    Write-Host "❌ GitHub连接失败" -ForegroundColor Red
}

if (Test-Connection -ComputerName "npmjs.com" -Count 1 -Quiet) {
    Write-Host "✅ NPM连接正常" -ForegroundColor Green
} else {
    Write-Host "❌ NPM连接失败" -ForegroundColor Red
}

Write-Host "===================="
Write-Host "✅ 系统检查完成" -ForegroundColor Green

🚨 常见问题解决

❓ 系统要求相关问题

Q1: 我的电脑配置较低,能否学习MCP?

A: 可以!MCP的基础学习对硬件要求不高。你可以:

  • 使用云开发环境(如GitHub Codespaces、Gitpod)
  • 专注于轻量级示例
  • 避免运行大型AI模型

Q2: 我在企业网络下,无法访问某些网站怎么办?

A: 企业环境解决方案:

  • 联系IT部门开放必要网站的访问权限
  • 使用企业内部的包管理镜像
  • 考虑使用离线安装包

Q3: Windows用户需要安装WSL吗?

A: 不是必需的,但强烈推荐:

  • WSL2提供更好的Linux兼容性
  • 许多MCP服务器更适合在Unix环境运行
  • 开发体验更接近生产环境

🎯 本节小结

通过这一小节,你应该已经了解了:

硬件要求:MCP开发所需的最低和推荐硬件配置
操作系统:支持的操作系统版本和选择建议
开发工具:必需的编辑器、版本控制和终端工具
网络要求:必要的网络访问和代理配置
容器化选项:Docker环境的使用方式
兼容性检查:自动化的系统检查方法

🎬 准备就绪检查清单

在进入下一小节之前,请确认你已经:

  • [ ] 确认系统满足最低硬件要求
  • [ ] 选择并准备好合适的操作系统
  • [ ] 安装了代码编辑器(推荐VS Code)
  • [ ] 配置了Git版本控制
  • [ ] 确认网络连接正常
  • [ ] 运行了系统兼容性检查脚本

一切准备就绪?让我们开始安装Node.js环境! 🚀


👉 下一小节:3.2 安装Node.js环境