mcp-vscode-template

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.prompt() ではなく @mcp.tool() を使用したことです。

サーバーの起動

プロジェクトの venv から、uv run external-recon.py でサーバーを起動します。
例：

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