Palveron Governance Gateway

io.github.palveron由 GitHub 账号 palveron 发布v1.0.4更新于 Oct 24, 2026

Advisory governance checks for MCP hosts; enforcement runs in the Palveron remote MCP proxy.

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

本地 MCP 服务器,让助手在调用工具前获得 Palveron 的咨询式治理检查:策略裁决、PII 脱敏结果和审计追踪 ID。

可以做什么
按治理策略检查拟执行的工具调用,返回裁决(通过、阻止、修改/脱敏/匿名化并附净化后的输入、待审批等)、发现项和审计追踪 ID。查询治理状态与诊断信息,如网关连通性、熔断器状态和已配置的本地名单。列出项目当前生效的策略,便于宿主解释裁决依据。使用本地始终阻止和始终放行名单,无需调用网关即可判定。
适用场景
适合希望在任意 MCP 宿主中获得策略裁决和审计追踪,或用代码以 Palveron 检查包装工具调用的场景。它只是咨询性质:调用方代理或你的代码必须遵守裁决。若需要无法绕过的强制治理,厂商建议改用其独立的远程 MCP 代理。
运行要求
通过 npm 包 @palveron/mcp-server 在本地运行(npx 或全局安装),需要 Node.js 18 或更高版本和支持 MCP 的客户端。需要 Palveron API 密钥,通过环境变量 PALVERON_API_KEY 提供,且须经 Early Access 邀请获取。可选配置:PALVERON_BASE_URL、PALVERON_FAIL_OPEN、PALVERON_LOG_LEVEL、PALVERON_ALWAYS_BLOCK、PALVERON_ALWAYS_ALLOW。需要能访问 Palveron 网关的网络。
安装前请注意
PALVERON_API_KEY 是密钥,通过宿主的环境配置设置。检查仅为咨询性质,若代理忽略裁决即可绕过;网关不可达时默认失败关闭,设置 PALVERON_FAIL_OPEN=true 则改为放行。工具调用详情(可能含个人数据的输入)会发送到 Palveron 网关,追踪 ID 会关联到 Palveron 仪表盘。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Palveron Governance Gateway,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@palveron/mcp-server

Official Palveron MCP server — advisory AI-governance checks for MCP hosts and coding agents

[npm version] [npm downloads] [License: MIT] [Documentation] [Early Access]


⚡ Early access. Palveron is launching soon and access is currently invite-gated. This server is fully functional — you just need a pv_live_ key, which comes with an Early Access invite. Join the waitlist → palveron.com/early-access

Give your MCP-capable client — Claude Code, Cursor, any other MCP host — governance tools it can call before executing an action: policy verdicts, PII-masking results, and an audit trace for every check, all from the Palveron AI Governance Gateway.

  • Drop-in MCP server — one binary, configure your MCP host, you're done
  • Advisory governance verdicts — the gateway decides allow / mask / deny / hold; the agent (or your wrapping code) acts on the verdict
  • Audit trail per check — trace IDs flow back to the Palveron dashboard
  • Built on @palveron/sdk — retry, circuit breaker, typed errors out of the box

Advisory check vs. enforced governance — which one do you need?

This package is the advisory path. It cannot physically stop a tool call: it answers the question "is this allowed?", and the calling agent (or your code via check()/wrap()) is expected to honor the answer. That is by design — it works with any MCP host, needs no network topology change, and gives you verdicts plus audit traces immediately.

Enforced, non-bypassable governance for MCP tool calls is a different product surface: the Palveron remote MCP proxy. There you register the target MCP server in the Palveron dashboard and point your IDE at POST {gateway}/api/v1/mcp/proxy/{server_id} instead of the target — every tools/call then structurally passes through policy checks, approval holds, and drift detection before it can reach the target server. No cooperation from the agent required.

This package (@palveron/mcp-server)Remote MCP proxy
ModelVoluntary pre-flight checkIn-path enforcement
Can a call bypass it?Yes — enforcement depends on the caller honoring the verdictNo — the proxy sits between client and target server
Setupnpx, one env varRegister the target server in the dashboard, point the IDE at the proxy URL
Use it whenYou want verdicts + audit traces inside any MCP host, or wrap tool calls programmaticallyYou need governance that agents cannot skip

See the MCP setup guide for the enforced path.

Installation

bash
npm install -g @palveron/mcp-server# or use directly via npxnpx @palveron/mcp-server

Quick Start

The pv_live_… key in the examples below requires an Early Access invite — request one here. Once you have a key, everything works out of the box.

Claude Code

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "palveron": {      "command": "npx",      "args": ["@palveron/mcp-server"],      "env": {        "PALVERON_API_KEY": "pv_live_xxx",        "PALVERON_BASE_URL": "https://gateway.palveron.com"      }    }  }}

Other MCP hosts

Any MCP-capable host can launch the server via the palveron-mcp binary:

bash
PALVERON_API_KEY=pv_live_xxx palveron-mcp

Tools exposed via MCP

ToolPurpose
palveron_checkCheck a tool call against governance policies before execution. Returns the decision (PASSED, BLOCKED, MODIFIED/REDACTED/ANONYMIZED with the sanitized input, PENDING_APPROVAL, …), whether the call may proceed, findings, and the audit trace ID.
palveron_statusGovernance status and diagnostics — gateway connectivity, circuit-breaker state, configured local lists.
palveron_policy_listList the project's active policies so the host can explain its decisions.

Configuration

The server reads its configuration from environment variables. The MCP host sets them; you never put secrets in code.

VariableRequiredDescription
PALVERON_API_KEYyesAPI key (pv_live_…) — comes with an Early Access invite
PALVERON_BASE_URLnoOverride the gateway endpoint (default: https://gateway.palveron.com)
PALVERON_FAIL_OPENnotrue = allow tool calls when the gateway is unreachable (default: false, fail-closed)
PALVERON_LOG_LEVELnodebug / info / warn / error / silent (default: info)
PALVERON_ALWAYS_BLOCKnoComma-separated tool names that are always denied locally, without a gateway call
PALVERON_ALWAYS_ALLOWnoComma-separated tool names that always pass locally, without a gateway call

Requirements

  • Node.js 18 or newer
  • An MCP-capable client (Claude Code 0.4+, Cursor, etc.)

Links

License

MIT — Copyright © 2026 Palveron.

来源:README.md,提交 536ec7d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.4最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分