nextcloud-mcp-server/tests/manual

Manual OAuth Flow Testing

This directory contains manual test scripts for OAuth flows that require browser interaction.

ADR-004 OAuth Hybrid Flow Test

The test_adr004_oauth_flow.py script tests the complete OAuth flow described in ADR-004.

Prerequisites

1. Install Playwright browsers:

   uv run playwright install firefox
   

2. Start MCP server with OAuth enabled:

   For Nextcloud OIDC:

   export ENABLE_OFFLINE_ACCESS=true
   export TOKEN_ENCRYPTION_KEY=$(uv run python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())")
   docker-compose up --build -d mcp-oauth
   

   For Keycloak:

   export ENABLE_OFFLINE_ACCESS=true
   export TOKEN_ENCRYPTION_KEY=$(uv run python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())")
   docker-compose up --build -d mcp-keycloak
   

Running the Test

Test with Nextcloud OIDC:

uv run python tests/manual/test_adr004_oauth_flow.py --provider nextcloud

Test with Keycloak:

uv run python tests/manual/test_adr004_oauth_flow.py --provider keycloak

Headless mode:

uv run python tests/manual/test_adr004_oauth_flow.py --provider nextcloud --headless