weblogic-mcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this is

An MCP (Model Context Protocol) server, implemented as a single Python file (src/wlst_mcp.py), that exposes Oracle WebLogic Server administration as MCP tools. It works by generating WLST (WebLogic Scripting Tool / Jython) script fragments at runtime, writing them to a temp file, and shelling out to the wlst.sh/wlst.cmd executable to run them.

Setup and running

pip install -r requirements.txt

Run directly (used as the MCP server entry point, normally launched by an MCP client, not by hand):

python src/wlst_mcp.py

There is no build step or lint config. There is a pytest suite under tests/ (install with pip install -r requirements-dev.txt, run with python -m pytest) that, without needing a live WebLogic domain:

• monkeypatches _execute_wlst_script to capture the generated WLST/Jython source instead of running it, then asserts on that source via the ast module (e.g. that user-supplied values can't break out of their string literal — test_tool_injection.py/test_script_injection.py) or via substring checks for code that's harder to parse generically (test_remote_filesystem_awareness.py, test_create_datasource.py).
• monkeypatches it to return canned/crafted stdout (including realistic WLST banner noise) to exercise the sentinel-line + JSON parsing and Markdown/JSON rendering on the Python side (test_core_utilities.py).
• tests Pydantic input validation and _handle_error directly (test_core_utilities.py).
• spawns a subprocess to verify wlst_execute_script's opt-in registration gate (test_execute_script_guardrails.py).

It does not exercise WLST itself — there is no way to validate the runtime behavior of a generated script (e.g. whether cmo.createJDBCSystemResource(...) actually works against a real domain) without one. For that, exercise the tool through an MCP client (e.g. Claude Code's .mcp.json/~/.claude.json config, see README.md) against a real or test WebLogic domain.