Palveron Governance Gateway

@palveron/mcp-server

Palveron 官方 MCP 服务 — 为 MCP 宿主和编码 Agent 提供顾问式 AI 治理检查

---

⚡ 抢先体验。 Palveron 即将推出，目前仅限受邀用户访问。此服务功能齐全——你只需要一个 pv_live_ 密钥，受邀参加抢先体验即可获得。加入候补名单 → palveron.com/early-access

为支持 MCP 的客户端（如 Claude Code、Cursor 或其他 MCP 宿主）提供可在执行操作之前调用的治理工具：策略判定、PII 脱敏结果，以及每次检查的审计跟踪，所有这些都来自 Palveron AI Governance Gateway。

• 即插即用的 MCP 服务 — 一个二进制文件，配置好 MCP 宿主即可使用
• 顾问式治理判定 — 网关决定允许 / 脱敏 / 拒绝 / 暂缓；Agent（或你的封装代码）根据判定采取行动
• 每次检查均有审计跟踪 — 跟踪 ID 会返回到 Palveron 控制面板
• 基于 @palveron/sdk 构建 — 开箱即用的重试、熔断器和类型化错误

顾问式检查与强制执行治理——你需要哪一种？

此软件包提供的是顾问式方案。它无法从物理层面阻止工具调用：它回答“是否允许？”这个问题，并期望发起调用的 Agent（或通过 check()/wrap() 调用的代码）遵从答案。这是有意为之——它适用于任何 MCP 宿主，无需更改网络拓扑，并能立即提供判定结果和审计跟踪。

针对 MCP 工具调用的强制执行、不可绕过的治理属于另一种产品形态：Palveron 远程 MCP 代理。你可以在 Palveron 控制面板中注册目标 MCP 服务，并将 IDE 指向 POST {gateway}/api/v1/mcp/proxy/{server_id}，而不是目标服务——这样，每次 tools/call 都会先经过策略检查、审批暂缓和漂移检测，然后才能到达目标服务。无需 Agent 配合。

	此软件包（@palveron/mcp-server）	远程 MCP 代理
模式	自愿的预先检查	链路内强制执行
调用能否绕过？	可以 — 是否执行取决于调用方是否遵从判定	不可以 — 代理位于客户端和目标服务之间
设置	npx，一个环境变量	在控制面板中注册目标服务，并将 IDE 指向代理 URL
适用场景	你希望在任意 MCP 宿主中获取判定结果和审计跟踪，或以编程方式封装工具调用	你需要 Agent 无法跳过的治理

如需了解强制执行方案，请参阅 MCP 设置指南。

安装

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

快速开始

以下示例中的 pv_live_… 密钥需要抢先体验邀请 — 在此申请。获取密钥后，一切即可开箱即用。

Claude Code

将以下内容添加到你的 claude_desktop_config.json：

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

其他 MCP 宿主

任何支持 MCP 的宿主都可以通过 palveron-mcp 二进制文件启动服务：

PALVERON_API_KEY=pv_live_xxx palveron-mcp

通过 MCP 暴露的工具

工具	用途
palveron_check	在执行前，根据治理策略检查工具调用。返回判定结果（PASSED、BLOCKED、MODIFIED/REDACTED/ANONYMIZED 及清理后的输入、PENDING_APPROVAL 等）、调用是否可以继续、检查结果以及审计跟踪 ID。
palveron_status	治理状态和诊断信息——网关连接状态、断路器状态、已配置的本地列表。
palveron_policy_list	列出项目的有效策略，以便主机解释其判定。

配置

服务从环境变量读取配置。MCP 主机负责设置这些变量；切勿将密钥写入代码。

变量	必需	描述
PALVERON_API_KEY	是	API 密钥（pv_live_…）——随 Early Access 邀请提供
PALVERON_BASE_URL	否	覆盖网关端点（默认值：https://gateway.palveron.com）
PALVERON_FAIL_OPEN	否	true = 网关无法访问时允许工具调用（默认值：false，即故障时拒绝）
PALVERON_LOG_LEVEL	否	debug / info / warn / error / silent（默认值：info）
PALVERON_ALWAYS_BLOCK	否	逗号分隔的工具名称列表：始终在本地拒绝，不调用网关
PALVERON_ALWAYS_ALLOW	否	逗号分隔的工具名称列表：始终在本地放行，不调用网关

要求

• Node.js 18 或更高版本
• 支持 MCP 的客户端（Claude Code 0.4+、Cursor 等）

链接

• Early Access / 等候名单 — palveron.com/early-access
• 文档 — docs.palveron.com/integrations/mcp
• 控制面板 — palveron.com
• 支持 — [email protected]
• GitHub — palveron/mcp-server
• 更新日志 — CHANGELOG.md

许可证

MIT — 版权所有 © 2026 Palveron。