name: 'pytest-mcp-plugin'

description: 'pytest for MCP servers — run your MCP test suite on every PR.'

author: 'yagna-1'

branding:

icon: 'check-circle'

color: 'green'

inputs:

command:

description: 'Command to start the MCP server (e.g. "python my_server.py").'

required: true

test-dir:

description: 'Directory containing pytest tests.'

required: false

default: 'tests'

python-version:

description: 'Python version to install.'

required: false

default: '3.12'

timeout:

description: 'Per-request timeout in seconds.'

required: false

default: '10'

extras:

description: 'pytest-mcp-plugin extras to install (comma-separated). Empty for none, "all" for http+schema.'

required: false

default: 'all'

mcptest-version:

description: 'pytest-mcp-plugin version to install (e.g. "0.2.0"). Empty for latest.'

required: false

default: ''

pytest-args:

description: 'Extra arguments to pass to pytest.'

required: false

default: '-v'

junit-xml:

description: 'Path to write a JUnit XML report. Empty to skip.'

required: false

default: 'mcptest-results.xml'

outputs:

junit-xml:

description: 'Path to the JUnit XML report (if generated).'

value: ${{ inputs.junit-xml }}

runs:

using: 'composite'

steps:

- name: Set up Python

uses: actions/setup-python@v5

with:

python-version: ${{ inputs.python-version }}

- name: Install pytest-mcp-plugin

shell: bash

run: |

set -euo pipefail

pkg="pytest-mcp-plugin"

if [ -n "${{ inputs.extras }}" ]; then

pkg="${pkg}[${{ inputs.extras }}]"

fi

if [ -n "${{ inputs.mcptest-version }}" ]; then

pkg="${pkg}==${{ inputs.mcptest-version }}"

fi

python -m pip install --upgrade pip

python -m pip install "${pkg}"

mcp-test --version

- name: Run pytest-mcp-plugin

shell: bash

run: |

set -euo pipefail

args=(

"${{ inputs.test-dir }}"

"--mcp-command=${{ inputs.command }}"

"--mcp-timeout=${{ inputs.timeout }}"

)

if [ -n "${{ inputs.junit-xml }}" ]; then

args+=("--junitxml=${{ inputs.junit-xml }}")

fi

# shellcheck disable=SC2206

extra=( ${{ inputs.pytest-args }} )

python -m pytest "${args[@]}" "${extra[@]}"

- name: Upload JUnit report

if: always() && inputs.junit-xml != ''

uses: actions/upload-artifact@v4

with:

name: mcptest-results

path: ${{ inputs.junit-xml }}

if-no-files-found: ignore