clouatre-labs/math-mcp-learning-server

OpenSSF Hardening, REUSE Compliance, and CI Quality

Achieves OpenSSF Best Practices silver, adds REUSE/SPDX license compliance, raises test coverage to 90%, and hardens CI with Scorecard, pip-audit, and commitlint.

Installation

# Local (stdio transport)
uvx math-mcp-learning-server

# Remote (streamable HTTP, no install needed)
# https://math-mcp.fastmcp.app/mcp

What's Changed

Features

• Prompt decorators: Enrich @mcp.prompt decorators with title, tags, and description metadata (#286)

Refactors

• Tool param constraints: Move parameter constraints to Field descriptions; strip Returns blocks from docstrings (#285)

Fixes

• Visualization tests: Guard matplotlib imports and correct VisualizationError assertions (#296)

Tests

• Coverage: Add targeted tests raising statement coverage to 90% and add branch coverage measurement (#303)
• Annotation assertions: Assert description completeness and schema examples (#283)

CI

• pip-audit: Add CVE scanning for Python dependencies (#297)
• commitlint: Enforce Conventional Commits on all PRs (#297)
• REUSE compliance: Add SPDX license headers and reuse workflow (#299)
• OpenSSF Scorecard: Add Scorecard workflow and badge (#301)

Docs

• SECURITY.md: Update supported versions and add release verification instructions (#298)
• Code review standards: Document code review and security review process (#302)
• OpenSSF badge infrastructure: Add GOVERNANCE, ASSURANCE docs and badge scripts (#305)
• OpenSSF Best Practices silver: Mention achievement in README and SECURITY.md (#309)
• Badges: Migrate REUSE and OpenSSF badges to shields.io (#311)
• Audit fixes: Fix accuracy and staleness issues across docs (#313)

Chores

• CODEOWNERS: Add CODEOWNERS and document branch protection setup (#300)
• Dependencies: Update clouatre-labs/aptu action to v0.2.18, v0.2.19 (#284, #312)
• Dependencies: Update actions/upload-artifact to v7 (#304)
• Dependencies: Pin and update @types/node to 22.19.15, then v25 (#306, #307)
• Cleanup: Remove .mailmap and its REUSE annotation (#308)

Full Changelog: https://github.com/clouatre-labs/math-mcp-learning-server/compare/v0.11.5...v0.12.0