关于 mcp-vscode-template
mcp-vscode-template 是用于构建 VS Code Agent MCP 服务的起始模板,提供设置说明和基于 uv 的 Python 示例服务流程。
主要功能
- 01VS Code Agent 服务模板
- 02Python 项目设置说明
- 03基于 uv 的环境配置
- 04MCP 工具装饰器示例
适用场景
- 01启动 VS Code Agent MCP 服务项目
- 02使用 uv 配置 Python MCP 环境
- 03在 VS Code 中配置 MCP 服务
MCP 相关
该模板指导用户创建并运行面向 VS Code Agent 的 MCP 服务,包括配置 VS Code 设置。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
mcp-vscode-template
适用于 VS Code Agent 的 MCP 服务模板
设置
按你喜欢的方式安装 uv。有多种可选方式。
https://docs.astral.sh/uv/getting-started/installation/
项目设置主要基于 Renae Schilg 的工作。我甚至没有更改项目名称,以此致敬,不过我在一些方面做了不同处理,主要是没有使用 Claude Desktop,并且对 external-recon.py 进行了大量修改。
https://nae-bo.medium.com/building-your-first-offensive-security-mcp-server-dd655e258d5f
# Initialize project
uv init external-recon
cd external-recon
我必须将 .python-version 中的 Python 版本改为 3.11,或其他高于 3.8 或 3.10 的版本
我还必须将 pyroject.toml 中的 requires-python = ">=3.11" 改为高于 3.8 或 3.10 的版本
具体情况可能有所不同……也可能不需要这样做。
# Create virtual environment and activate it
uv venv --python 3.11
source .venv/bin/activate
# Install mcp
uv add "mcp[cli]"
# Install dnspython (dependency for external-recon.py, not necessary for all projects, but for this one yes)
uv pip install dnspython
# Create MCP server external-recon.py file or empty and rename main.py
touch external-recon.py
应修改 VS Code 的 settings.json。
使用 which uv 查找 uv 的路径。
"/path/to/project/external-recon" 应指向项目路径,即 MCP 服务 .py 文件所在的位置(使用绝对路径)。
settings.json
"mcp": {
"servers": {
"external-recon": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/project/external-recon",
"run",
"external-recon.py"
]
}
}
},
Renae 的工作与我的工作之间一个主要区别是,我在 external-recon.py 中使用了 @mcp.tool(),而不是 @mcp.prompt()
启动服务
在项目的 venv 中,使用 uv run external-recon.py 启动服务
示例:
(external-recon) user@workstation external-recon % uv run external-recon.py
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。