Sidclaw Governance Mcp

io.github.VladUZH由 GitHub 帳號 VladUZH 發布v0.1.13更新於 Oct 25, 2026

Governance proxy for MCP servers — policy evaluation, human approval, audit trails.

概覽

AI 產生的概覽

一個本機治理代理,包裝任意 MCP 伺服器,依 SidClaw 政策檢查每次工具呼叫,並將高風險動作暫停等待人工核准並留下紀錄。

可以做什麼
攔截並轉送工具呼叫到你設定的上游 MCP 伺服器,讓助理的工具經由 SidClaw 執行而非直接運行。依政策評估每次呼叫,在執行前回傳允許、需核准或拒絕。將高風險動作暫停等待人工審核,可立即回傳或阻塞至作出決定。把每次決定記入防竄改的稽核紀錄。
適用情境
當你希望監督 AI 助理透過 MCP 工具執行的動作時使用,尤其是刪除、部署、交易或寄送客戶郵件等破壞性或高影響動作。適合需要人工核准檢查點與稽核紀錄以符合法規要求的團隊。
執行需求
透過 npm 套件以 stdio 在本機執行。需要 SIDCLAW_AGENT_ID、密鑰 SIDCLAW_API_KEY、用於指定被包裝伺服器的 SIDCLAW_UPSTREAM_CMD 與 SIDCLAW_UPSTREAM_ARGS;SIDCLAW_APPROVAL_MODE 為選用。需要連線至 SidClaw API(託管或自架)的網路存取及 SidClaw 帳號。
安裝前請注意
API 金鑰是傳送給 SidClaw 服務的機密,該服務會接收工具呼叫細節與稽核資料。核准模式 block 會暫停工具呼叫直到有人作出決定。代理位於另一個伺服器之前,該伺服器本身的權限與風險仍然存在。自架部署附有預設開發憑證,應予以變更。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Sidclaw Governance Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

SidClaw

Approve, deny, and audit AI agent tool calls.

Works with MCP, LangChain, OpenAI Agents, Claude Agent SDK, and 15+ more.

[GitHub stars] [npm version] [PyPI version] [License: Apache-2.0] [License: FSL] [Tests] [CI]

Website · Documentation · Live Demo · SDK on npm · SDK on PyPI


Your agents call tools without oversight. SidClaw intercepts every tool call, checks it against your policies, and holds risky actions for human review before they execute.

Try it locally (10 seconds, no signup)

bash
npx sidclaw-demo

Opens a local governance dashboard at http://localhost:3030 with four pre-loaded scenarios (Claude Code rm -rf, fintech trade, DevOps scale-to-zero, clinical lab order). No signup, no Docker, no API key — just the approval card UX running in your browser.

See it in action

[Atlas Financial Demo]

Agent wants to send an email → policy flags it → reviewer sees full context → approves or denies → trace recorded.

Works With Your Stack

SidClaw integrates with 18+ frameworks and platforms — including OpenClaw (329K+ users), LangChain, OpenAI, MCP, Claude Agent SDK, Google ADK, NemoClaw, Copilot Studio, GitHub Copilot, and more. Add governance in one line of code. See all integrations →

See It In Action

Customer Support Agent (Financial Services)

[Atlas Financial Demo]

An AI agent wants to send a customer email. Policy flags it for review. The reviewer sees full context — who, what, why — and approves with one click. Every step is traced.

Infrastructure Automation (DevOps)

[DevOps Demo]

An AI agent wants to scale production services. High-risk deployments require human approval. Read-only monitoring is allowed instantly.

Clinical Decision Support (Healthcare)

[Healthcare Demo]

An AI assistant recommends lab orders. The physician reviews the clinical context and approves. Medication prescribing is blocked by policy — only physicians can prescribe.

How It Works

Agent wants to act → SidClaw evaluates → Policy decides → Human approves (if needed) → Action executes → Trace recorded

Four primitives govern every agent action:

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐│ Identity │ →  │  Policy  │ →  │ Approval │ →  │  Trace   ││          │    │          │    │          │    │          ││ Every    │    │ Every    │    │ High-risk│    │ Every    ││ agent    │    │ action   │    │ actions  │    │ decision ││ has an   │    │ evaluated│    │ get human│    │ creates  ││ owner &  │    │ against  │    │ review   │    │ tamper-  ││ scoped   │    │ explicit │    │ with rich│    │ evident  ││ perms    │    │ rules    │    │ context  │    │ audit    │└──────────┘    └──────────┘    └──────────┘    └──────────┘
  • allow → action executes immediately, trace recorded
  • approval_required → human sees context card, approves/denies, trace recorded
  • deny → blocked before execution, no data accessed, trace recorded

Deploy your own SidClaw instance ($0)

Railway is the recommended one-click deploy — it spins up Postgres + API + Dashboard together. Vercel hosts only the Next.js dashboard; pair it with a hosted API.

[Deploy on Railway]

Vercel (dashboard only — point at an existing SidClaw API)
https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fsidclawhq%2Fplatform&root-directory=apps%2Fdashboard&env=NEXT_PUBLIC_API_URL&envDescription=Your%20SidClaw%20API%20base%20URL%20(e.g.%20https%3A%2F%2Fapi.sidclaw.com)

Vercel can only host the dashboard (Next.js). The API is Fastify — deploy it to Railway, Fly, Render, or run via Docker. Set NEXT_PUBLIC_API_URL on the dashboard project to point at it.

Under 3 minutes to a working instance on Railway.


Quick Start — Pick What Fits

Option 1: Claude Code Hooks (zero code)

For Claude Code users. Every Bash, Write, Agent, mcp__* tool call is governed by SidClaw:

bash
# In the SidClaw platform reponpm run hooks:install
# Then set two env varsexport SIDCLAW_BASE_URL=https://api.sidclaw.comexport SIDCLAW_API_KEY=ai_your_key_here

Restart Claude Code. rm -rf pauses for approval, git push --force gets flagged, every tool call is traced with a hash-chained audit trail. See hooks/README.md.

Option 2: create-sidclaw-app (interactive scaffold)

bash
npx create-sidclaw-app my-agentcd my-agentnpm start

Option 3: MCP Governance Proxy (zero code, wraps any MCP server)

Jump to the MCP Governance Proxy section below.

Option 4: SDK wrapper (one line per tool)

typescript
// Before: the agent decides, nobody reviewsawait sendEmail({ to: "[email protected]", subject: "Follow-up", body: "..." });
// After: wrap with SidClaw — now policies applyconst sendEmail = withGovernance(client, {  operation: 'send_email',  data_classification: 'confidential',}, sendEmailFn);
await sendEmail({ to: "[email protected]", subject: "Follow-up", body: "..." });// → allow (executes) | approval_required (human reviews) | deny (blocked)
Same thing in Python
python
@with_governance(client, GovernanceConfig(    operation="send_email",    data_classification="confidential",))def send_email(to, subject, body):    email_service.send(to=to, subject=subject, body=body)
Full TypeScript example with imports
bash
npm install @sidclaw/sdk
typescript
import { AgentIdentityClient, withGovernance } from '@sidclaw/sdk';
const client = new AgentIdentityClient({  apiKey: process.env.SIDCLAW_API_KEY,  apiUrl: 'https://api.sidclaw.com',  agentId: process.env.SIDCLAW_AGENT_ID,});
const sendEmail = withGovernance(client, {  operation: 'send_email',  target_integration: 'email_service',  resource_scope: 'customer_emails',  data_classification: 'confidential',}, async (to, subject, body) => {  await emailService.send({ to, subject, body });});
await sendEmail('[email protected]', 'Follow-up', 'Hello...');// allow → executes | approval_required → waits for human | deny → throws
Full Python example with imports
bash
pip install sidclaw
python
import osfrom sidclaw import SidClawfrom sidclaw.middleware.generic import with_governance, GovernanceConfig
client = SidClaw(    api_key=os.environ["SIDCLAW_API_KEY"],    agent_id=os.environ["SIDCLAW_AGENT_ID"],)
@with_governance(client, GovernanceConfig(    operation="send_email",    target_integration="email_service",    data_classification="confidential",))def send_email(to, subject, body):    email_service.send(to=to, subject=subject, body=body)

MCP Governance Proxy

Wrap any MCP server with policy evaluation and approval workflows. Works with Claude Desktop, Cursor, VS Code, GitHub Copilot — any MCP client. Listed on the official MCP Registry.

Add to your .mcp.json:

json
{  "mcpServers": {    "postgres-governed": {      "command": "npx",      "args": ["-y", "@sidclaw/sdk", "sidclaw-mcp-proxy", "--transport", "stdio"],      "env": {        "SIDCLAW_API_KEY": "ai_your_key",        "SIDCLAW_AGENT_ID": "your-agent-id",        "SIDCLAW_UPSTREAM_CMD": "npx",        "SIDCLAW_UPSTREAM_ARGS": "-y,@modelcontextprotocol/server-postgres,postgresql://localhost/mydb"      }    }  }}
  • SELECT * FROM customers → allowed (~50ms overhead)
  • DELETE FROM customers WHERE id = 5 → held for human approval
  • DROP TABLE customers → denied by policy

Full MCP governance docs →

Why not just auth / sandboxing / logging?

ApproachWhat it solvesWhat it doesn't solve
Auth (Okta, OAuth)Who is this agent?Should this specific action execute right now?
Sandboxing (Docker, WASM)Blast radius if something goes wrongWhether the action should happen at all
Logging (Langfuse, LangSmith)What happened after the factIntercepting actions before they execute
Policy engines (OPA)General-purpose policy evaluationApproval workflows, agent-specific context, audit trails
SidClawAll of the above, plus the Approval primitive—

SidClaw sits at the tool-call layer: the moment an agent decides to act in the real world.

Integrations

SidClaw wraps your existing agent tools — no changes to your agent logic.

Agent Frameworks

TypeScriptPython
Core client@sidclaw/sdksidclaw
MCP proxy@sidclaw/sdk/mcpsidclaw.mcp
LangChain@sidclaw/sdk/langchainsidclaw.middleware.langchain
OpenAI Agents@sidclaw/sdk/openai-agentssidclaw.middleware.openai_agents
CrewAI@sidclaw/sdk/crewaisidclaw.middleware.crewai
Vercel AI@sidclaw/sdk/vercel-ai—
Pydantic AI—sidclaw.middleware.pydantic_ai
Claude Agent SDK@sidclaw/sdk/claude-agent-sdksidclaw.middleware.claude_agent_sdk
Google ADK@sidclaw/sdk/google-adksidclaw.middleware.google_adk
LlamaIndex@sidclaw/sdk/llamaindexsidclaw.middleware.llamaindex
Composio@sidclaw/sdk/composiosidclaw.middleware.composio
NemoClaw@sidclaw/sdk/nemoclawsidclaw.middleware.nemoclaw
Webhooks@sidclaw/sdk/webhookssidclaw.webhooks

Platform Integrations

IntegrationDescription
Claude CodeGovern any MCP server in Claude Code. Add a .mcp.json entry — zero code changes. Guide →
OpenClawGovernance proxy for OpenClaw skills. Published as sidclaw-governance on ClawHub. Guide →
MCPGovernance proxy for any MCP server. Listed on the official MCP Registry. CLI binary (sidclaw-mcp-proxy) + programmatic API. Guide →
NemoClawGovern NVIDIA NemoClaw sandbox tools with MCP-compatible proxy generation. Guide →
Copilot StudioGovernance for Microsoft Copilot Studio skills via OpenAPI action. Guide →
GitHub CopilotGovernance for GitHub Copilot agents via HTTP transport. Guide →
GitHub Actionsidclawhq/governance-action@v1 — reusable CI governance step. Guide →

Notification Channels

Approval requests are delivered to your team's preferred channels. Reviewers can approve or deny directly from chat.

ChannelFeatures
SlackBlock Kit messages with interactive Approve/Deny buttons. Messages update in-place after decision.
Microsoft TeamsAdaptive Card notifications with Approve/Deny buttons (Bot Framework) or dashboard links (webhook).
TelegramHTML messages with inline keyboard. Callback updates remove buttons and add reply.
ResendEmail notifications for approval requests via transactional email.

Licensing

ComponentLicenseWhat you can do
SDK (@sidclaw/sdk, sidclaw on PyPI)Apache 2.0Use freely, modify, distribute, commercial use
MCP Proxy (sidclaw-mcp-proxy)Apache 2.0Same as SDK
Platform (API, Dashboard, Docs)FSL 1.1Free for orgs under CHF 1M revenue. Converts to Apache 2.0 in 2028

Start with just the SDK? You don't need the platform. The SDK works standalone with the free hosted API at app.sidclaw.com, or you can self-host everything.

Why This Exists

AI agents are being deployed in production, but the governance layer is missing:

  • 73% of CISOs fear AI agent risks, but only 30% are ready (NeuralTrust 2026)
  • 79% of enterprises have blind spots where agents act without oversight
  • FINRA 2026 explicitly requires "documented human checkpoints" for AI agent actions in financial services
  • EU AI Act mandates human oversight, automatic logging, and risk management for high-risk AI systems — obligations apply from 2 December 2027 (Annex III) and 2 August 2028 (product-embedded), deferred from August 2026 by the 2026 Digital Omnibus
  • OpenClaw has 329K+ stars and 13,700+ skills — but 1,184 malicious skills were found in the ClawHavoc campaign. There's no policy layer governing what skills can do.

The big vendors (Okta, SailPoint, WorkOS) handle identity and authorization. But none of them ship the approval step — the part where a human sees rich context and makes an informed decision before an agent acts.

Compliance

SidClaw maps to regulatory requirements across the US, EU, Switzerland, and Singapore:

🇺🇸 FINRA 2026 · 🇪🇺 EU AI Act · 🇨🇭 FINMA · 🇸🇬 MAS TRM · 🇺🇸 NIST AI RMF · 🌐 OWASP Agentic

Platform Features

For Developers

  • 60-second setup — npx create-sidclaw-app scaffolds a working governed agent
  • <50ms evaluation overhead — the governance layer is invisible to your users
  • 5-minute integration — wrap existing tools, no code changes
  • MCP-native — governance proxy for any MCP server
  • Framework-agnostic — LangChain, Vercel AI, OpenAI, CrewAI, Pydantic AI, Composio, Claude Agent SDK, Google ADK, LlamaIndex, NemoClaw, or plain functions
  • Typed SDKs — TypeScript (npm) + Python (PyPI)

For Security & Compliance Teams

  • Policy engine — allow / approval_required / deny with priority ordering and classification hierarchy
  • Approval workflow — context-rich cards with agent reasoning, risk classification, and separation of duties
  • Audit trails — correlated traces with integrity hash chains (tamper-evident)
  • SIEM export — JSON and CSV, continuous webhook delivery

For Platform Teams

  • RBAC — admin, reviewer, viewer roles with enforced permissions
  • Tenant isolation — automatic tenant scoping on every query
  • API key management — scoped keys with rotation
  • Rate limiting — per-tenant, per-endpoint-category
  • Webhooks — real-time notifications for approvals, traces, lifecycle events
  • Chat integrations — approve/deny from Slack, Teams, or Telegram without opening the dashboard
  • Self-serve signup — GitHub, Google, email/password

Architecture

┌─────────────┐     ┌──────────────┐     ┌──────────────────┐│ Your Agent  │     │  SidClaw SDK │     │  SidClaw API     ││             │ ──► │              │ ──► │                  ││ LangChain   │     │ evaluate()   │     │ Policy Engine    ││ MCP Server  │     │ withGovern() │     │ Approval Service ││ OpenAI SDK  │     │ governTools()│     │ Trace Store      ││ Any tool    │     │              │     │ Webhook Delivery │└─────────────┘     └──────────────┘     └──────────────────┘                                                   │                                          ┌────────┴────────┐                                          ▼                 ▼                                ┌──────────────┐  ┌──────────────┐                                │  Dashboard   │  │ Notifications│                                │              │  │              │                                │ Agents       │  │ Slack        │                                │ Policies     │  │ Teams        │                                │ Approvals    │  │ Telegram     │                                │ Traces       │  │ Email        │                                │ Settings     │  │ Webhooks     │                                └──────────────┘  └──────────────┘

Deploy

One-Click Deploy

[Deploy on Railway]

Deploy from the GitHub repo to Railway. Add a PostgreSQL database, configure environment variables, and you're live.

[Deploy with Vercel]

Deploy the dashboard to Vercel (requires a separately hosted API).

Deploy Docs or Landing Page to Vercel

Docs:

[Deploy with Vercel]

Landing Page:

[Deploy with Vercel]

Self-Host (Docker)

bash
curl -sSL https://raw.githubusercontent.com/sidclawhq/platform/main/deploy/self-host/setup.sh | bash

Or manually:

bash
git clone https://github.com/sidclawhq/platform.gitcd platformcp deployment/env.example .env  # edit with your valuesdocker compose -f docker-compose.production.yml up -d

Development credentials:

  • Email: [email protected] / Password: admin
  • Or click "Sign in with SSO" on the login page to auto-login without a password

Hosted Cloud

No infrastructure to manage. Start free at app.sidclaw.com

See deployment documentation for production configuration, environment variables, and upgrade guides.

Documentation

  • Quick Start — 2 minutes to first governed action
  • SDK Reference — every method documented
  • Integrations — MCP, OpenClaw, NemoClaw, LangChain, OpenAI, Claude Agent SDK, Google ADK, Copilot Studio, GitHub Copilot, and more
  • Policy Guide — authoring, versioning, testing
  • Compliance — 🇺🇸 FINRA · 🇪🇺 EU AI Act · 🇨🇭 FINMA · 🇸🇬 MAS TRM · 🇺🇸 NIST AI RMF · 🌐 OWASP
  • API Reference — every endpoint

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

The SDK (packages/sdk/) is Apache 2.0. The platform (apps/) is FSL 1.1.

License

  • SDK (packages/sdk/, packages/shared/): Apache License 2.0 — use freely for any purpose
  • Platform (apps/api/, apps/dashboard/, apps/docs/, apps/landing/, apps/demo*/): Functional Source License 1.1 — source-available. Cannot offer as a competing hosted service. Converts to Apache 2.0 after 2 years (March 2028).

Links

來源:README.md,提交 eaa0d3d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.13最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分