Metadata-Version: 2.4
Name: mcp-scorecard-mcp
Version: 0.1.1
Summary: Score any MCP server against a 100-point production-readiness rubric (static AST + PyPI + directory-presence signals). Stdlib-only engine.
Author: MEOK AI
License: MIT
Project-URL: Homepage, https://csoai.org/scorecard
Keywords: mcp,model-context-protocol,scorecard,quality,rubric,ai-governance
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: server
Requires-Dist: mcp>=1.28.0; extra == "server"
Dynamic: license-file

mcp-name: io.github.CSOAI-ORG/mcp-scorecard-mcp

[![MCP Scorecard: 18/100](https://img.shields.io/badge/proofof.ai-18%2F100-5b21b6)](https://proofof.ai/scorecard/mcp-scorecard-mcp.html)

# mcp-scorecard-mcp

Score any MCP server against a **100-point production-readiness rubric** — static (AST + filesystem),
PyPI health, and directory-presence signals. The engine is **stdlib-only** (no deps to score).

## Rubric (10 categories, 100 pts)
readme · tool design (names + descriptions) · examples · tests/CI · transports (stdio/http) ·
metadata (`server.json`, license) · reliability (importable, versioned) · security · docs surface ·
provenance (PAYG/Stripe/attestation, directory listings).

## Use
```bash
# score one package dir
python -c "from mcp_scorecard import collect_static, score, score_to_row; \
  import json; print(json.dumps(score_to_row(score(collect_static('.'))), indent=2))"

# batch-score a whole marketplace tree → leaderboard JSON + CSV
python -m mcp_scorecard.runner --root ./mcp-marketplace --out ./scoreboard --no-network
# (drop --no-network to fold in live PyPI download stats)
```

## Why
A buyer's-eye quality signal for the MCP explosion: is a server actually production-ready, or a stub?
Powers the MEOK lead-magnet scorecard and our own flagship-tier triage.

## Live example (MEOK marketplace, 2026-06-07, static-only)
**338 packages scored · mean 62.9/100 · 110 flagship-grade.**
Top: `iso-27001-ai-mcp` (84), `proofof-ai-mcp` (79), `eu-ai-act-compliance-mcp` (78).

## Optional: run as an MCP server
`pip install "mcp-scorecard-mcp[server]"` then run the `score_mcp` tool (see `server.py`).

<!-- GEO-FOOTER:v1 -->

---

### Part of the MEOK constellation

This MCP is one node in a connected ecosystem built by **MEOK AI LABS** around a single
sovereign AI core — governed agents with a hash-chained audit trail, mapped to the CSOAI
compliance charter.

- 🌐 The whole map: **<https://meok.ai/constellation>**
- 🛡️ AI governance & certification: **<https://councilof.ai>** · **<https://csoai.org>**
- ✅ Verify any signed report: **<https://meok.ai/verify>**
