Skip to main content
Glama

spring-mosaic

MCP server that reviews SoftTech Java / Spring Boot / PostgreSQL repositories, scores changes against org standards, and returns actionable feedback so teams follow best practices.

Sibling of ai-mosaic (Angular / TS frontends).

Package: @himakarinv-stack/spring-mosaic · GitHub Packages

What it does for SoftTech repos

Step

Tool

Detect stack

detect_spring_context

Plan the review

review_pr_diff

Scan changes

audit_changed_files / audit_workspace

Standards

get_pr_review_brief, get_review_sections_for_diff, get_quality_guide

Architecture

review_architecture

Agents should install this MCP in backend repos (HRMS, APIs, etc.) and run the workflow on every PR / local change set.

Related MCP server: GitHub PR Review MCP Server

Install into a Spring / Java repo

1. Authenticate (one-time)

@himakarinv-stack:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN

2. Install + wire Cursor

npm install --save-dev @himakarinv-stack/spring-mosaic
npx spring-mosaic-setup

Or:

npx --registry=https://npm.pkg.github.com -p @himakarinv-stack/spring-mosaic spring-mosaic-setup

Suggested review workflow

detect_spring_context
  → review_pr_diff (changed files)
  → audit_changed_files
  → get_pr_review_brief + get_review_sections_for_diff
  → write human feedback (blockers → info) using review-format

Tools

Tool

Purpose

detect_spring_context

Boot/Java version, Maven/Gradle, modules

list_quality_domains

Domain index

get_quality_guide

One standards section

explain_pattern

Topic deep-dive

get_pr_review_brief

Review format + anti-patterns

get_review_sections_for_diff

Sections for changed extensions

review_pr_diff

PR orchestration plan

audit_changed_files

Structured feedback on a change set

audit_workspace

Scan a path under the repo

review_architecture

Layer checklist

scan_violations

Single-file heuristic scan

Local develop

cd "d:/softtech/MCP servers/spring-mosaic"
npm install
npm run build
npx spring-mosaic-setup --local --target path/to/java-repo

See CONTRIBUTING.md and PUBLISH.md.

Available Tools

9 tools
detect_spring_contextA

Detect Spring Boot / Java version, build tool, and modules. Call first.

Inputs: workspaceRoot.

explain_patternC

Deep-dive on a Spring/Java topic (jpa, rest, security, transactions, etc.).

Inputs: topic (required), workspaceRoot.

get_pr_review_briefC

Minimal PR review brief: review format + anti-patterns.

Inputs: workspaceRoot.

get_quality_guideC

Fetch ONE quality guide. spring-boot is version-scoped (boot2 vs boot3).

Inputs: domain (required), workspaceRoot.

get_review_sections_for_diffC

Return only quality sections relevant to changed file types.

Inputs: changedExtensions (required), workspaceRoot.

list_quality_domainsA

Index of Java/Spring quality domains. Call first to discover what to fetch.

Inputs: no named parameters.

review_architectureC

Architecture checklist for a Java/Spring diff.

Inputs: changedFiles (required), workspaceRoot.

review_pr_diffD

PR review orchestration: changed files, extensions, and review steps.

Inputs: changedFiles (required), workspaceRoot.

scan_violationsC

Heuristic scan of Java/Kotlin source for common Spring anti-patterns.

Inputs: source (required), filePath (required), workspaceRoot.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 9 tools

    Disambiguation4/5

    Tools are mostly distinct with clear purposes. Some overlap exists between PR review tools (e.g., get_pr_review_brief vs review_pr_diff), but descriptions differentiate them effectively.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., detect_spring_context, list_quality_domains), making them predictable and easy to use.

    Tool Count5/5

    With 9 tools, the server is well-scoped for its purpose (Spring/Java quality and PR review). No tool feels unnecessary, and the count is appropriate for the domain.

    Completeness5/5

    The tool set covers the full lifecycle of quality analysis: detection (detect_spring_context), exploration (list_quality_domains, get_quality_guide, explain_pattern), and PR review (brief, sections, orchestration, architecture, scanning). No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers