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

# 初始化项目
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 的版本。 结果可能因情况而异... 可能没有必要。

# 创建虚拟环境并激活它
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 文件所在的位置（使用绝对路径）。

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