Register a virtual environment as active in the current session.

This does not "activate" the venv in a shell sense (which is a shell-level operation). Instead, it records the venv path in the session so that subsequent python_* and pip_* tool calls use the venv's interpreter and pip automatically.

Detect project type, framework, and key configuration files.

Identifies Python, Node.js, .NET, Rust, Go, Java, Docker, and other project types automatically by checking for characteristic files.

    Append content to an existing file (or create it if it does not exist).

    Args:
        path:     Path to the file.
        content:  Content to append.
        encoding: File encoding. Default: "utf-8".

    Returns:
        A dict with keys: status, data (path, total_size_bytes).

    Examples:
        append_file("log.txt", "New entry

") append_file("output.csv", "row1,row2 ")

Check whether a package is installed and return its version.

Send an HTTP HEAD request to verify URL accessibility and inspect response headers.

Clear the session command history.

This does not affect the working directory, environment variables, or any other session state. Only the command history is cleared.

Returns: A dict with keys: status, data (confirmation message).

Examples: clear_session_history()

Copy a file to a new location within the workspace.

Count lines of code across the codebase.

Counts total lines, code lines (non-blank, non-comment), blank lines, and comment lines per file extension.

Return CPU usage statistics and core information.

Returns: A dict with keys: status, data (cores, usage%, frequency).

Examples: cpu_info()

Create a directory and all necessary parent directories.

Create a new Python virtual environment.

Deactivate the current session's virtual environment.

After this call, python_* and pip_* tools will use the system Python interpreter.

Returns: A dict with keys: status, data (confirmation).

Examples: deactivate_venv()

Permanently delete a file from the workspace.

This operation is irreversible. Requires explicit confirmation when security.require_confirmation is enabled (default: True).

Return disk partition information and usage for each drive.

Returns: A dict with keys: status, data (list of partition details).

Examples: disk_info()

Perform a DNS lookup for the given hostname.

Build a Docker image from a Dockerfile.

Stop and remove Docker Compose services.

Return logs from Docker Compose services.

Start Docker Compose services.

Execute a command inside a running container.

Return Docker system-wide information.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: docker_info()

List Docker containers.

List Docker images.

Return logs from a container.

Pull a Docker image from a registry.

Remove a Docker container.

Run a Docker container.

Stop a running container.

Return the installed Docker version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: docker_version()

Fetch a web page and extract human-readable body text.

Strips script, style, and HTML markup tags to produce clean text.

Fetch static web page content over HTTP/HTTPS.

Check whether a path exists within the workspace.

Return metadata for a file or directory.

Includes size, creation time, modification time, file type, and whether the path is readable/writable.

Search for TODO/FIXME/HACK and similar tags in source files.

Return the value of an environment variable.

Checks session-scoped overrides first, then falls back to the inherited process environment.

Return local network adapter information and IP addresses.

Includes all IPv4 and IPv6 addresses for each active adapter.

Returns: A dict with keys: status, data (hostname, adapters list).

Examples: get_ip_info()

List locally open (listening) TCP and UDP ports.

Return detailed information about a specific process.

Return recent command history for the current session.

History entries include the command, tool name, exit code, timestamp, and duration. History is capped at 500 entries.

Return a snapshot of the current session state.

Includes the working directory, last exit code, active virtual environment, active Git repository, active project, and session start time.

Returns: A dict with keys: status, data (session snapshot).

Examples: get_session_info()

Return the current session working directory.

The working directory persists across all tool calls within the same server session. It defaults to the user's home directory on startup.

Returns: A dict with keys: status, data (containing cwd, exists, is_dir).

Examples: get_working_directory()

Stage files for commit.

Show line-by-line authorship information for a file.

List local (or all) branches and indicate the current branch.

Switch to a branch, or restore a file to its last committed state.

Clone a remote repository into a local directory.

The destination must be within the workspace boundary.

Create a commit with the staged changes.

Requires explicit confirmation when security.require_confirmation is enabled in config (default: True).

Create a new branch and switch to it.

Show changes between commits, working tree, or index.

Check GitHub authentication status and token validity.

Returns whether a token is configured and (if so) the authenticated user's login name.

Returns: A dict with keys: status, data (authenticated, token_present, user).

Examples: github_auth_status()

Create a new GitHub issue.

Requires a GITHUB_TOKEN with issue write permissions and explicit confirmation when required by config.

Get a specific GitHub issue by number.

Get a specific pull request by number.

List issues for a GitHub repository.

List pull requests for a repository.

List releases for a repository.

Check the current GitHub API rate limit status.

Returns: A dict with keys: status, data (core, search, and graphql limits).

Examples: github_rate_limit()

Return metadata for a GitHub repository.

Search GitHub repositories.

Initialise a new Git repository.

The target path must be within the workspace boundary.

Return recent commit history.

Pull changes from a remote repository.

Push commits to a remote repository.

Requires explicit confirmation when security.require_confirmation is enabled in config (default: True).

Show configured remote repositories and their URLs.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_remote_info()

Stash or restore uncommitted changes.

Return the current Git working tree status.

Shows the state of the index and working directory — which files are staged, unstaged, or untracked.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_status()

List all tags in the repository.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_tags()

Perform an HTTP GET request and return the response.

Useful for testing APIs and web endpoints. Response body is truncated at 10,000 characters.

Install a Python package with pip.

Requires explicit confirmation when security.require_confirmation is enabled in config.

List the contents of a directory.

List all environment variables visible to the MCP server process.

Returns both process-level and session-scoped overrides. Session overrides are marked with source: "session" in the output.

List all installed Python packages.

List running processes with resource usage.

List Windows services with their status.

Return RAM and virtual memory statistics.

Returns: A dict with keys: status, data (total, available, used, percent for RAM and swap).

Examples: memory_info()

Move or rename a file within the workspace.

Execute a JavaScript file with Node.js.

Return the installed Node.js version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: node_version()

Fetch information about an npm package from the registry.

Install npm packages.

List installed npm packages.

Run an npm script defined in package.json.

Return the installed npm version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: npm_version()

Execute a command with npx.

Open a URL in the default system web browser.

Ping a host and return round-trip statistics.

Output installed packages in requirements.txt format.

Useful for generating a requirements.txt file or auditing the exact package versions in the current environment.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: pip_freeze()

Return the current pip version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: pip_version()

Return a comprehensive project overview combining multiple analyses.

Combines project type detection, LOC counting, and TODO/FIXME listing into a single structured report.

Return comprehensive Python environment information.

Includes version, executable path, platform, prefix, and active virtual environment (if any).

Returns: A dict with keys: status, data (detailed env info).

Examples: python_info()

Return the current Python interpreter version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: python_version()

Read and return the contents of a text file.

Parse and summarise a package.json file.

Returns project name, version, description, scripts, dependencies, and devDependencies.

Parse and summarise a pyproject.toml file.

Returns project name, version, description, dependencies, and tool configurations.

Execute a CMD command and return the output.

Useful for legacy batch operations, tools that behave differently under CMD, or when PowerShell is unavailable.

Execute a PowerShell command and return the output.

The command passes through the full security validation pipeline before execution. Dangerous commands (format, shutdown, etc.) are blocked automatically.

Execute a Python script file.

The script must be within the workspace boundary. Uses the active virtual environment's Python if one is registered in the session.

Execute a PowerShell (.ps1) or batch (.bat/.cmd) script file.

Resolves the script path relative to the current working directory. The script must exist within the configured workspace boundary.

Search for files matching a glob pattern.

Change the current session working directory.

The new directory must exist and must be within the configured workspace boundary. Relative paths are resolved against the current working directory.

Search for SQLite database files within the workspace.

Execute any SQL statement against a SQLite database.

Write operations (INSERT, UPDATE, DELETE, CREATE, DROP, etc.) require explicit confirmation.

List all tables in a SQLite database file.

Execute a read-only SELECT query against a SQLite database.

Only SELECT statements are allowed. Use sqlite_execute for writes.

Return the CREATE statement(s) for tables in a database.

Return column definitions for a specific table.

Return comprehensive system information.

Includes OS version, hostname, uptime, Python version, architecture, and processor brand.

Returns: A dict with keys: status, data (detailed system snapshot).

Examples: system_info()

Trace the network route to a host.

Return a directory tree view up to a specified depth.

Uninstall a Python package with pip.

Requires explicit confirmation (passes --yes to pip to avoid interactive prompt).

Return detailed Windows version information.

Returns: A dict with keys: status, data (version, build, edition strings).

Examples: windows_version()

    Create or overwrite a file with the given content.

    Creates parent directories automatically. Overwrites existing files
    without warning — use file_exists() first if unsure.

    Requires explicit confirmation when ``security.require_confirmation``
    is enabled in config.

    Args:
        path:     Path to write (absolute or relative to cwd).
        content:  The text content to write.
        encoding: File encoding. Default: "utf-8".
        confirm:  Set to True to confirm when required by config.

    Returns:
        A dict with keys: status, data (path, size_bytes, lines).

    Examples:
        write_file("notes.txt", "Hello, World!")
        write_file("src/config.py", "DEBUG = True

", confirm=True)