io.github.Ciphermap-io/ciphermap-mcp
Officialby Ciphermap-io
README.md
<!-- mcp-name: io.github.Ciphermap-io/ciphermap-mcp -->
# CipherMap Local MCP Referee, `pre-commit` Hook & Multi-SCM CI Integration (`v1.0.6`)
Configuration templates, `pre-commit` hook definitions, and Official MCP Registry metadata (`server.json`) for running **[CipherMap](https://www.ciphermap.io)** (`v1.0.6`) as:
1. A **100% local `stdio` Model Context Protocol (MCP) Referee** (`11` tools, `0` open network sockets) inside **Claude Code**, **Cursor**, **VS Code (`@mcp`)**, **GitHub Copilot**, and **Windsurf** (`ciphermap mcp --workspace .`).
2. A **shift-left `pre-commit` hook** scanning staged diffs in `<250ms` (`--staged --offline`).
3. A **zero-egress CI/CD gate & signed CycloneDX 1.6 / 1.7 (ECMA-424) CBOM generator** across **GitHub Actions**, **Bitbucket Pipelines / Data Center**, **GitLab CI**, and **Azure DevOps**.
[](https://www.ciphermap.io/scan?utm_source=mcp_readme&utm_medium=badge)
> **Zero Source Egress:** CipherMap ships as native Apple Developer ID (`ZLF7244KA7`) and Microsoft Authenticode signed binaries ([download evaluation pack](https://www.ciphermap.io/eval-pack)). No source code, `.p12`/`.jks` keystores, or AST fragments ever leave your workstation or self-hosted runner (`--offline --no-telemetry`).
---
## 1. Local `stdio` MCP Server (`ciphermap mcp` — 11 Tools in `v1.0.6`)
CipherMap's local MCP server auto-detects both newline-delimited JSON-RPC 2.0 and `Content-Length` framed `stdio` with zero network egress, exposing **11 deterministic verification & compliance tools**:
| MCP Tool | Purpose |
|---|---|
| `ciphermap_scan_all` | Runs local 12-language PQC (`PQC-*`, `PQC-PRE-001..005`, `.jar`/`.p12`) and structural handler/AI-config (`IMM-*`, `IMM-AICFG-001`) discovery. |
| `ciphermap_check_baseline_health` | Runs sandboxed `T0` compiler/typecheck health probes and formal `T0`/`T1` fault attribution before edits. |
| `ciphermap_inspect_rule` | Returns NIST FIPS 203/204/205, CNSA 2.0, `SC-081` 100-day TLS, CWE, and wire-protocol constraints before an agent drafts code. |
| `ciphermap_recommend_pqc_sdk` | Recommends constant-time finalized FIPS 203 (`ML-KEM`), FIPS 204 (`ML-DSA`), and FIPS 205 (`SLH-DSA`) libraries (preventing Round-3 `kyber768`/`dilithium3` drift). |
| `ciphermap_verify_dependencies` | Firewalls proposed PQC/crypto packages against slopsquatting and timing-unsafe fallbacks. |
| `ciphermap_extinguish_immunity` | Synthesizes polyglot AST & `.cursorrules`/`CLAUDE.md`/`.mcp.json` codemods verified via 4-Gate compiler/test witnesses + `ddmin` salvage. |
| `ciphermap_verify_candidate_fix` | Stages candidate edits inside an ephemeral network-denied sandbox copy (never mutating live files) and returns structured counterexamples on failure. |
| `ciphermap_verify_workspace_clean` | Verifies zero remaining policy blockers and validates `Ed25519 + ML-DSA-65` ProofBundles prior to commit. |
| `ciphermap_generate_cbom` | Emits deterministic CycloneDX 1.7 or 1.6 (ECMA-424) CBOM summaries across source, `.jar`/`.whl` archives, and `.p12`/`.jks` keystores. |
| `ciphermap_generate_pqc_wrapper` | Previews zero-code compensating PQC termination configs (`Envoy`, `NGINX`, `HAProxy`, `K8s`, `IPsec`, `cert-manager`, `CNSA 2.0`). |
| `ciphermap_compliance_crosswalk` | Maps workspace cryptographic assets across **16 global regulatory mandates** (`CNSA 2.0`, `PCI-DSS 4.0.1`, `FedRAMP`, `CMMC 2.0`, `EU DORA`, `NIS2`, `OSCAL 1.1.2`, etc.). |
### Cursor (`.cursor/mcp.json`) & VS Code (`.vscode/mcp.json`)
```json
{
"mcpServers": {
"ciphermap": {
"command": "ciphermap",
"args": ["mcp", "--workspace", "."]
}
}
}
```
### Claude Code (`.mcp.json` or `~/.claude.json`)
```json
{
"mcpServers": {
"ciphermap": {
"type": "stdio",
"command": "ciphermap",
"args": ["mcp", "--workspace", "."]
}
}
}
```
### Emit 5-Agent Herd-Immunity Guardrails (`Cursor`, `Claude Code`, `Copilot`, `Windsurf`, `Gemini`)
```bash
ciphermap immunity emit-agent-rules . --write
```
---
## 2. Shift-Left `pre-commit` Hook (`<250ms` Offline Staged Scan)
Add to `.pre-commit-config.yaml` to block legacy crypto regressions, Round-3 `kyber768` hallucinations, and Trojan Unicode `.cursorrules`/`CLAUDE.md` poisoning (`IMM-AICFG-001`) before commit:
```yaml
repos:
- repo: https://github.com/Ciphermap-io/ciphermap-mcp
rev: v1.0.6
hooks:
- id: ciphermap
```
---
## 3. Enterprise GitHub Actions (`Ciphermap-io/ciphermap-action`) & OWASP Dependency-Track v5 CBOM Ingestion
Use [`Ciphermap-io/ciphermap-action`](https://github.com/Ciphermap-io/ciphermap-action) (pinned to its immutable 40-char commit SHA) to upload SARIF 2.1.0 to **GitHub Code Scanning** and stream signed **CycloneDX 1.7 CBOMs** straight into **OWASP Dependency-Track v5**:
```yaml
- name: Run CipherMap Zero-Egress PQC & CycloneDX 1.7 CBOM Gate
uses: Ciphermap-io/ciphermap-action@b1379b1e9e40b396d0f15844feb01f15b3378b7c # v1.0.6
with:
fail-on: high
target: cnsa-2.0
include-archives: "true"
cbom-file: cbom.cdx.json
cbom-spec-version: "1.7"
license-key: ${{ secrets.CIPHERMAP_LICENSE }}
- name: Upload CycloneDX 1.7 CBOM to OWASP Dependency-Track v5 (Optional)
if: env.DTRACK_API_KEY != ''
env:
DTRACK_URL: ${{ secrets.DTRACK_URL }}
DTRACK_API_KEY: ${{ secrets.DTRACK_API_KEY }}
DTRACK_PROJECT_UUID: ${{ secrets.DTRACK_PROJECT_UUID }}
run: |
curl --proto '=https' --tlsv1.2 -fsSL -X POST "${DTRACK_URL}/api/v1/bom" \
-H "X-Api-Key: ${DTRACK_API_KEY}" \
-F "project=${DTRACK_PROJECT_UUID}" \
-F "bom=@cbom.cdx.json"
```
- **Instant Public GitHub & Bitbucket URL Scanner:** [https://www.ciphermap.io/scan](https://www.ciphermap.io/scan)
- **Methodology & Scope Boundaries:** [https://www.ciphermap.io/methodology](https://www.ciphermap.io/methodology)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues