Skip to main content
Glama
venv-mcp-server

venv-mcp-server

by sparfenyuk

venv-mcp-server

The MCP server which solves the following problem: LLMs are not able to resolve dependencies and update the virtual environment on their own reliably. With simple list of tools, venv-mcp-server makes it possible.

Integrations

Cline / Claude Desktop

{
  "mcpServers": {
    "venv-management-for-my-project": {
      "command": "uvx",
      "args": [
        "--from=git+https://github.com/sparfenyuk/venv-mcp-server.git",
        "venv-mcp-server"
      ]
    }
  }
}

Related MCP server: mcp-python-repl

Command-line arguments

$ uvx --from git+https://github.com/sparfenyuk/venv-mcp-server.git venv-mcp-server --help
usage: venv-mcp-server [-h] [--uv-path UV_PATH]

A MCP server to manage a virtual environment in the given location using 'uv'

options:
  -h, --help         show this help message and exit
  --uv-path UV_PATH  Path to uv executable. Default is the 'uv' command in your PATH.

Available Tools

6 tools
add_packageC

Add package to pyproject.toml and update the virtual environment. Returns True if successful.

Args: package_name: Name of the package to install. dev: If True, add the package to the development dependency group.

Inputs: package_name (required), dev (required), current_working_dir (required).

add_packagesA

Add many packages to pyproject.toml at once and update the virtual environment.

Args: package_names: List of names of the packages to install. dev: If True, add the package to the development dependency group.

Inputs: package_names (required), dev (required), current_working_dir (required).

initC

Initialize virtual environment. Returns True if successful.

Inputs: current_working_dir (required).

remove_packageB

Remove package from pyproject.toml file and update the virtual environment. Returns True if successful.

Args: package_name: Name of the package to remove. dev: If True, remove the package from the development dependency group

Inputs: package_name (required), dev (required), current_working_dir (required).

run_in_venvC

Run a command in virtual environment. Returns True if successful.

Args: command: Command to run. args: Arguments to pass to the command.

Inputs: current_working_dir (required), command (required), args.

syncC

Sync pyproject.toml with virtual environment. Returns True if successful.

Inputs: current_working_dir (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: init, add/remove packages (singular/plural), sync, and run commands. No overlap or ambiguity.

    Naming Consistency4/5

    All tools use snake_case and follow a verb_noun pattern (add_package, remove_package, run_in_venv), but 'init' and 'sync' are single words, which is a minor deviation.

    Tool Count5/5

    6 tools cover the essential operations for virtual environment management (init, add, remove, sync, run). No excess or deficiency.

    Completeness4/5

    Covers core workflows: init, add/remove packages, sync, run commands. Missing operations like listing installed packages or updating packages, but not critical.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A production-grade MCP server providing a persistent Python REPL with multi-session support, sandboxing, and timeout protection, enabling LLM agents to execute Python code across multiple turns with variables that persist between calls.
      12
      31 PyPI
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A local MCP server that provides a safe, structured way to manage Python environments inside a project workspace, including virtual environment creation, restricted pip operations, and dependency freezing.
      5
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Python venv runtime for AI agents. MCP server exposing list/create/describe/install/run/exec/snapshot/rollback/scan as typed tools
      52
      MIT