JinDaGe - mcp-vscode-template MCP Details

article

README

🚀 mcp-vscode-template

MCP 服务器模板用于 VS Code Agent，可帮助你快速搭建相关开发环境，提升开发效率。

🚀 快速开始

✨ 安装 uv

你可以根据自己的喜好选择安装 uv 的方式，具体安装指南可参考：uv 安装指南

📦 项目设置

本项目的设置很大程度上基于 Renae Schilg 的工作，可参考其文章：构建你的第一个进攻性安全 MCP 服务器。虽然在某些方面有所不同，例如不使用 Claude Desktop，并且对 external-recon.py 进行了较大修改，但仍保留了原项目名称以表敬意。

初始化项目

# 初始化项目
uv init external-recon
cd external-recon

修改 Python 版本

需要将 .python-version 文件中的 Python 版本修改为 3.11 或更高版本（高于 3.8 或 3.10），同时将 pyproject.toml 中的 requires-python = ">=3.11" 修改为高于 3.8 或 3.10 的版本。不过具体情况可能有所不同，不一定需要进行此修改。

创建虚拟环境并安装依赖

# 创建虚拟环境并激活它
uv venv --python 3.11
source .venv/bin/activate

# 安装 mcp
uv add "mcp[cli]"

# 安装 dnspython（external-recon.py 的依赖项，对于此项目是必要的）
uv pip install dnspython

# 创建 MCP 服务器 external-recon.py 文件或空文件并重命名 main.py
touch external-recon.py

修改 VS Code 的 settings.json

使用 which uv 来找到 uv 的路径，"/path/to/project/external-recon" 应该是指向项目路径的绝对路径，其中 MCP 服务器 .py 文件所在的目录（请使用绝对路径）。

{
    "mcp": {
        "servers": {
            "external-recon": {
                "command": "/path/to/uv",
                "args": [
                    "--directory",
                    "/path/to/project/external-recon",
                    "run",
                    "external-recon.py"
                ]
            }
        }
    }
}

🔧 启动服务器

从项目的虚拟环境中启动服务器，使用 uv run external-recon.py。示例：

(external-recon) user@workstation external-recon % uv run external-recon.py

💡 使用建议

在修改 Python 版本和 pyproject.toml 文件时，建议先备份原文件，以防出现问题。
在修改 settings.json 文件时，请确保路径的准确性，否则可能导致服务器无法正常启动。

mcp-vscode-template