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 分