MCP学习笔记
MCP学习笔记
最近由于组织架构变动，负责AI相关工具建设，学习一下MCP相关的知识
1、MCP介绍
1.1、什么是MCP
MCP（Model Context Protocol，模型上下文协议）是 Anthropic 开发的一个开放标准协议，用于让 AI 助手能够安全地连接各种外部数据源和工具。
- 为 AI 应用提供统一的方式来访问数据和工具
- 类似于 USB-C 接口 - 一个标准协议连接多种服务
- 让 AI模型 能够访问文件系统、数据库、API 等外部资源
1.2、MCP组成部分
MCP Server（服务器）
提供特定功能的服务
- 文件系统访问
- 数据库查询
- Web 搜索
- 第三方 API 集
MCP Client（客户端）
使用这些服务的应用
- Claude Code CLI
- Claude Desktop
- 其他集成了 MCP 的应用
2、uv
新一代高性能 Python 包管理工具，官网文档：https://docs.astral.sh/uv/
2.1、旧python包管理工具
1、pip
pip 是 Python 官方推荐的包管理器，主要用于安装和卸载 Python 包，支持从 PyPI、Git 仓库、本地目录等多种来源安装
优点
- 广泛使用，社区支持良好
- 简单易用，适合初学者
缺点
- 不支持依赖锁定
- 缺乏虚拟环境和项目管理功能
2、pip-tools
pip-tools 是由 Jazzband 社区维护的工具集，旨在增强 pip 的功能
pip-compile：从requirements.in生成锁定的requirements.txtpip-sync：根据requirements.txt安装或卸载依赖
优点
- 确保项目依赖的一致性
- 与 pip 兼容，易于集成
缺点
- 依赖解析速度较慢
- 功能相对单一，仅处理依赖锁定
3、pipx
pipx 是由 PyPA 维护的工具，专注于在隔离的环境中安装和运行 Python 命令行应用
- 在隔离的虚拟环境中安装 CLI 工具
- 运行一次性命令
优点
- 避免全局污染，隔离性好
- 便于管理和运行 CLI 工具
4、poetry
Poetry 是由 Python 社区开发的项目管理工具，旨在简化依赖管理和打包发布流程
- 使用
pyproject.toml管理项目依赖 - 自动创建和管理虚拟环境
- 构建和发布 Python 包
优点
- 一体化管理项目生命周期
- 使用
pyproject.toml，符合 PEP 518 标准
缺点
- 依赖解析速度较慢
- 对 Python 版本管理支持有限
5、pyenv
pyenv 是由社区开发的工具，用于安装和管理多个 Python 版本
- 安装和切换多个 Python 版本
- 支持全局和本地（每个项目）版本设置
优点
- 支持多个 Python 版本的切换
- 适用于开发和测试不同版本的兼容性
缺点
- 安装新版本需编译，耗时较长
- 不支持 Windows 系统
6、virtualenv
virtualenv 是由社区开发的工具，用于创建隔离的 Python 虚拟环境
- 创建隔离的虚拟环境
- 支持不同项目使用不同的依赖
优点
- 轻量级，创建环境速度快
缺点
- 不包含依赖管理功能
- 需要与 pip 或 pip-tools 结合使用
2.2、什么是uv
由 Astral 公司用 Rust 开发的高性能Python 包管理工具，旨在提供比传统 pip 更快的包安装和依赖管理体验，并整合了多个传统 Python 工具的核心功能，实现了 “一个工具搞定包管理、环境管理、版本管理、打包发布” 的一站式体验
- 比 pip 快 10-100 倍
- 锁文件保证依赖一致性
- 单一工具替代 pip、pip-tools、pipx、poetry、pyenv、virtualenv
- 完全兼容 pip 和 PyPI
- 包管理 + 项目管理 + Python 版本管理
2.3、安装uv
1、安装
macOS/Linux
# 1、官方安装脚本curl-LsSf https://astral.sh/uv/install.sh|sh# 2、Homebrewbrewinstalluv# 3、pippipinstalluvwindows
# 1、官方安装脚本powershell -c"irm https://astral.sh/uv/install.ps1 | iex"# 2、pippipinstalluv2、验证
uv -V uv --version2.3、使用uv
1、Python 版本管理
安装 Python
# 列出所有可用的 Python 版本(简介版)uv python list# 安装指定版本 Pythonuv pythoninstall3.14# 安装多个版本uv pythoninstall3.113.123.13# 卸载 Python 版本uv python uninstall3.11# 列出本地已安装的所有 Python 版本uv python list --only-installed设置全局 Python 版本
# 1、使用环境变量（推荐）vim~/.zshrcexportUV_PYTHON="3.14"source~/.zshrc# 2、使用全局配置文件mkdir-p ~/.config/uvcat>~/.config/uv/uv.toml<<'EOF' [python] # 默认 Python 版本 default = "3.12" # Python 查找偏好 preference = "managed" # 优先使用 uv 管理的 Python EOF2、项目管理
创建项目
# 创建应用项目uv init my-app# 在现有目录初始化uv initmy-app/ ├── .gitignore ├── .python-version # Python 版本锁定 ├── main.py ├── pyproject.toml # 项目配置 ├── README.md └── uv.lock # 记录所有依赖的精确版本 类似package-lock.json依赖管理
# 添加生产依赖uvaddrequests# 添加指定版本依赖uvadd"django==5.0"# 添加开发依赖uvaddpytest --dev# 移除依赖uv remove django# 安装项目所有依赖uvsync# 生成/更新锁文件uv lock运行项目
如果 project.scripts 发生变动要首先执行 uv sync
. ├── README.md ├── pyproject.toml ├── src │ ├── main.py │ └── weather │ ├── __init__.py │ └── weather.py └── uv.lock# src/weather/weather.pydeftoday_weather():return"It's rainy tomorrow!"deftomorrow_weather():return"It's sunny tomorrow!"# src/weather/__init__.pyfrom.weatherimporttoday_weatherfrom.weatherimporttomorrow_weather[project] name = "xumeng03-mcp" version = "0.1.0" description = "Add your description here" readme = "README.md" requires-python = ">=3.14" dependencies = [ "requests>=2.32.5", ] [project.scripts] today_weather = "xumeng03_mcp.weather:today_weather" tomorrow_weather = "xumeng03_mcp.weather:tomorrow_weather" [dependency-groups] dev = [ "pytest>=9.0.2", ] [build-system] requires = ["setuptools>=61.0"] build-backend = "setuptools.build_meta" [tool.setuptools] package-dir = {"xumeng03_mcp" = "src"}tomorrow_weather uv run tomorrow_weather3、工具管理
全局安装和管理 Python 的工具
- 安装在独立的隔离环境中
- 全局可用（任何地方都能运行）
# 安装工具uv toolinstallruff# 安装指定版本工具uv toolinstall"black==24.10.0"# 查看已安装的工具uv tool list# 升级单个工具uv tool upgrade ruff# 升级单个工具到指定版本uv toolinstall--upgrade"ruff==0.8.5"# 升级所有工具uv tool upgrade --all# 卸载单个工具uv tool uninstall ruff# 卸载多个工具uv tool uninstall black ruff mypy4、其他
# 清理缓存uv cache clean# 构建项目uv build