MCP Client 笔记

MCP Client 笔记

1.条件与环境

1.1 前提条件

软件/账号 是否必须
VSCode 1.93+ Y
Node.js 18.x+ JavaScript/TypeScript 实现的MCP服务必须
Python 3.10+ Y
uv Y
AI API Key Y

1.2 本文运行环境

平台/软件 版本
操作系统 Windows 10 企业版 22H2 19045.4046 64位
VSCode 1.98.2
Python 3.12.3
uv 0.6.8

2.开发

2.1 连接单个stdio服务的客户端（官方案例/Python）

2.1.1 创建项目

1.按官方示例【点击直达】初始化Python项目：

1
2
3
4
5
6
7
8
9
10
11
12
# 初始化项目
uv init mcp-client
cd mcp-client

# 创建虚拟环境
uv venv

# 进入虚拟环境
.venv\Scripts\activate

# 添加依赖
uv add mcp anthropic python-dotenv

image-20250321105507451

image-20250321105615900

项目文件目录结构：

image-20250321105906117

2.删除main.py；创建client.py，复制官方示例代码【点击直达】

2.1.2 修改代码

1.官方示例使用的模型是claude，claude-api-key需要充值使用，因此替换为其他可用渠道（比如改为使用gpt-4o），需要修改代码，修改后的完整代码【点击直达】；

需添加相关依赖：

1
2
.venv\Scripts\activate
uv add 'openai'

image-20250321165833314

2.创建.env，根据使用的模型进行设置，比如使用OpenAI的模型，则设置OPENAI_API_KEY=具体的api-key值和OPENAI_BASE_URL=OPENAI API地址（注意不要将该文件提交到GitHub仓库中以避免泄漏：echo ".env" >> .gitignore）

2.1.3 测试客户端

在终端窗口运行：

1
2
3
4
# 用uv命令运行
uv run client.py ../weather/main.py
# 也可以用python命令运行
python client.py ../weather/main.py

查询天气：

image-20250324174317000

相关链接