artemis

The Artemis MCP server is a Python-based server that integrates with the Artemis SAST tool to provide a modular MCP interface. It exposes an HTTP/SSE endpoint for scanning tasks and can be controlled via common command line options. Start the server to begin listening for MCP clients, which can send scan requests and receive results through the configured port and host. The server supports a help output that outlines available flags and usage patterns, including specifying a rule path and the server host/port to bind to. Typical usage involves running the module directly and then connecting a client to the given host and port to submit and monitor scans.

Usage highlights:

• Run the server with Python: python3 -m artemis-mcp-server --help to see usage details.
• Start with a specific host/port: python3 -m artemis-mcp-server -s 127.0.0.1 -p 8088
• Options include: -r, --rule: path to the scanning rule -s, --server: MCP server host to bind to -p, --port: MCP server port The server is designed to work with Artemis scans; you configure the scanner via the build.properties in the project root to ensure the Artemis scanner compiles and runs properly, enabling the MCP flow between the client and the Artemis engine.

Prerequisites:

• Python 3.8+ (recommended)
• Java JDK (as required by the Artemis scanner for building the project)
• Maven (used by Artemis to build the scanner/engine)

Installation steps:

1. Clone the MCP server repository:

git clone https://github.com/yourorg/artemis-mcp-server.git
cd artemis-mcp-server

2. Set up Python environment (optional but recommended):

python3 -m venv venv
source venv/bin/activate

3. Install Python dependencies (if any are listed in requirements.txt):

pip install -r requirements.txt

4. Ensure Java and Maven are installed for the Artemis scanner:

java -version
mvn -version

5. Configure the build.properties at the project root as indicated in the README (example provided in the config section of the README):

# Example content
java_home = /Library/Java/JavaVirtualMachines/jdk1.8.0_151.jdk/Contents/Home
build_cmd= mvn clean package -X -DskipTests=true

6. Run the MCP server:

python3 -m artemis-mcp-server -s 127.0.0.1 -p 8088

7. Verify the server is listening and responsive by requesting help or connecting with an MCP client to the configured host/port.

Tips and considerations:

• The server relies on the Artemis scanner being buildable via Maven; ensure build.properties points to valid Java home and a correct Maven command.
• If you need to customize the scan rules, pass a rule path with -r or --rule when appropriate for the Artemis integration.
• The config snippet in the README shows an example for artemis-mcp-server with SSE transport and a local URL at http://127.0.0.1:8088/sse. Adapt the host/port as needed for your environment.
• Common issues include Java not found (check JAVA_HOME) or Maven build failures due to missing dependencies. Ensure the environment variables and paths are correctly set.
• While this MCP server is Python-based, the underlying Artemis scanner may require Java tooling to compile and run; align your environment accordingly.