Oauth2 Authorization Server MCP Server

@musabbozkurt

Basic information

About Oauth2 Authorization Server MCP Server

OAuth2 Authorization Server with MariaDB, Docker OpenTelemetry LGTM, and Redis Integrations with Spring Boot 4, Java 25 and Docker. Integration Tests with Testcontainers and unit Tests with Junit 5, and Mockito

#docker #redis#aot-compilation#mariadb#spring-security#flyway#mapstruct#testcontainers#vector-database#springdoc-openapi#oauth2-authorizationserver#spring-boot-3#retrieval-augmented-generation #ollama#archunit-junit5#ai-advisor#java-24#mcp-server #mcp-client#coordinated-restore-at-checkpoint

Oauth2 Authorization Server MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "oauth2-authorization-server": {
      "command": "docker",
      "args": [
        "compose",
        "--profile",
        "start_application",
        "up",
        "-d",
        "--build"
      ]
    }
  }
}

Oauth2 Authorization Server MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Oauth2 Authorization Server?

An OAuth2 Authorization Server built with Spring Boot 4 and Java 25. It provides full OAuth2 authorization flows, supports multiple deployment options (Docker, native image with GraalVM, CRaC), and integrates with databases, Redis, LDAP, and local AI models for development and testing. It targets developers building or testing OAuth2-protected applications.

How to use Oauth2 Authorization Server?

Install Java 25, Maven, and Docker. Set environment variables for AI model API keys (optional). Run tests with mvn clean verify. Start the application with docker compose --profile start_application up -d --build or using ./mvnw spring-boot:run after starting infrastructure services. Access Swagger UI at http://localhost:9000/swagger-ui/index.html with client ID client and secret secret, and login with default users (Developer/password, Admin/password, User/password).

Key features of Oauth2 Authorization Server

OAuth2 authorization with Spring Boot 4 and Java 25
Multiple authentication providers (LDAP, database, default users)
Integration with Redis, MariaDB, and Ollama AI models
Docker, GraalVM native images, and CRaC support
Actuator endpoints and Grafana monitoring
AI model testing via Docker Desktop Model Runner

Use cases of Oauth2 Authorization Server

Authorization server for microservices and web applications
Local development and testing of OAuth2 flows with Postman
Learning Spring Security OAuth2 and Spring Boot 4 patterns
Running AI models alongside authorization logic for AI‑powered apps

Frequently asked questions

What are the prerequisites?

Java 25, Maven, and Docker must be installed. Postman is recommended for testing.

How to run the application?

Use Docker Compose: `docker compose --profile start_application up -d --build` for a full stack, or run `./mvnw spring-boot:run` after starting infrastructure services (Redis, MariaDB, LDAP, Ollama) with `docker compose up -d`.

How to test the API?

Import the Postman collection and environment files from the `docs/postman` folder. Alternatively, use Swagger UI at `http://localhost:9000/swagger-ui/index.html` with client credentials `client:secret`.

What infrastructure services are needed?

Redis (port 6379), MariaDB (port 3306), and LDAP are core. For AI features, Ollama and Docker Model Runner are required.

Does this server support AI models?

Yes. It can run AI models locally via Ollama or Docker Desktop Model Runner. The tests and optional features use models like `mxbai-embed-large`, `mistral`, and `deepseek-r1:7b`.