Skip to content

Commit eca948b

Browse files
authored
docs(ecosystem): add OPA MCP (#8618)
Adds **OPA MCP** to the ecosystem listing. - **Repo:** https://github.com/OrygnsCode/opa-mcp-server - **npm:** https://www.npmjs.com/package/@orygn/opa-mcp - **Docker Hub:** https://hub.docker.com/r/orygn/opa-mcp OPA MCP is a Model Context Protocol server that gives MCP-compatible clients (Claude Desktop, Cursor, VS Code, Zed, Windsurf, etc.) a structured interface to Rego. It wraps the OPA CLI, the OPA REST API, and the Regal linter behind 32 schema-validated tools, plus higher-level helpers (`rego_explain_decision`, `rego_describe_policy`, `rego_generate_test_skeleton`, `rego_suggest_fix`) that compose the primitives into agent-friendly workflows. ## Files - `docs/src/data/ecosystem/entries/opa-mcp.md` — entry following the format of `vscode-opa.md` and `regal.md`. - `docs/static/img/ecosystem-entry-logos/opa-mcp.png` — 256×256 logo, ~55 KB. ## Labels - `category: tooling` - `layer: editor` ## docs_features `learning-rego`, `policy-testing`, `debugging-rego`, `editors` — all chosen from the existing taxonomy used by other entries. Signed-off-by: OrygnsCode <38231263+OrygnsCode@users.noreply.github.com>
1 parent 796db6b commit eca948b

2 files changed

Lines changed: 52 additions & 0 deletions

File tree

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: OPA MCP
3+
subtitle: Model Context Protocol server for authoring and debugging Rego
4+
labels:
5+
category: tooling
6+
layer: editor
7+
inventors:
8+
- independent
9+
code:
10+
- https://github.com/OrygnsCode/opa-mcp-server
11+
docs_features:
12+
learning-rego:
13+
note: |
14+
OPA MCP exposes higher-level helpers (rego_describe_policy,
15+
rego_suggest_fix, rego_explain_decision) that compose opa fmt,
16+
opa parse, and opa eval into AI-friendly tools. Agents in any MCP
17+
client (Claude Desktop, Cursor, VS Code, Zed) can author, format,
18+
and review Rego with structured output instead of free-form CLI text.
19+
policy-testing:
20+
note: |
21+
The rego_test tool runs opa test over a directory and returns
22+
pass/fail per test with optional coverage. rego_generate_test_skeleton
23+
produces a _test.rego scaffold covering each rule in a policy.
24+
debugging-rego:
25+
note: |
26+
rego_explain_decision wraps opa eval --explain=full and returns a
27+
structured trace, letting agents answer "why was this rejected"
28+
without reading raw traces. rego_eval_with_profile and
29+
rego_eval_with_coverage surface hot rules and per-line coverage.
30+
editors:
31+
note: |
32+
OPA MCP is a stdio MCP server that plugs into any MCP-compatible
33+
client. One-line Smithery install for Claude Desktop, drop-in
34+
configs for Cursor, VS Code, Zed, and Windsurf. Multi-arch Docker
35+
image and a signed .mcpb bundle are also published.
36+
---
37+
38+
OPA MCP is a Model Context Protocol server that gives MCP-compatible
39+
clients a structured interface to Rego. It wraps the OPA CLI (opa fmt,
40+
opa check, opa eval, opa test, opa build, opa sign), the OPA REST API,
41+
and the Regal linter, exposing 32 tools with stable error codes and
42+
schema-validated input/output.
43+
44+
Higher-level helpers (rego_explain_decision, rego_describe_policy,
45+
rego_generate_test_skeleton, rego_suggest_fix) compose the primitives
46+
into the tasks agents typically perform. A curated resource set exposes
47+
the OPA built-in function catalog, the Rego style guide, and a pattern
48+
library covering RBAC, ABAC, Kubernetes admission, IaC gates, API
49+
authorization, and rate limiting.
50+
51+
Distributed via npm (@orygn/opa-mcp), Docker Hub (orygn/opa-mcp), and a
52+
signed .mcpb bundle.
55.2 KB
Loading

0 commit comments

Comments
 (0)