雪松-政策- mcp-schema-生成器-wasm

WASM 绑定 雪松政策- mcp-schema-生成器,显示 SchemaGenerator 到 Java 脚本和 TypeScript 通过 wasm-bindgen。 。 。 .

这使得Node.js和浏览器环境能够从 MCP 工具描述中生成 Cedar 授权计划 完全一样的行为 包括正确处理:

• 贾森 number 作为 Long 或者说 Decimal (可配置)
• additionalProperties 作为锡达标记的实体
• 嵌入对象的空格类型分解

使用量

安装 npm 包 :

npm install @cedar-policy/mcp-schema-generator-wasm

const { generateSchema } = require('@cedar-policy/mcp-schema-generator-wasm');

const stub = `
namespace MyServer {
    @mcp_principal
    entity User;
    @mcp_resource
    entity McpServer;
    action "call_tool" appliesTo {
        principal: [User],
        resource: [McpServer]
    };
}
`;

const tools = JSON.stringify([
  {
    name: 'read_file',
    description: 'Read a file from disk',
    inputSchema: {
      type: 'object',
      properties: { path: { type: 'string' } },
      required: ['path'],
    },
  },
]);

const result = JSON.parse(generateSchema(stub, tools));

if (result.isOk) {
  console.log(result.schema);     // Human-readable .cedarschema
  console.log(result.schemaJson); // JSON for Cedar WASM isAuthorized()
} else {
  console.error(result.error);
}

API 密码

generateSchema(schemaStub, toolsJson, configJson?)

回返情况: JSON 有字段的字符串 :

配置

{
  "includeOutputs": false,
  "objectsAsRecords": false,
  "eraseAnnotations": true,
  "flattenNamespaces": false,
  "numbersAsDecimal": false,
  "deduplicateEntityTypes": false
}

generateRequest(schemaStub, toolsJson, inputJson, principalType, principalId, resourceType, resourceId, configJson?)

从 MCP 工具调用中生成 Cedar 授权请求组件 .

回返情况: JSON 有字段的字符串 :

示例

const { generateRequest } = require('@cedar-policy/mcp-schema-generator-wasm');

const stub = `
namespace MyServer {
    @mcp_principal
    entity User;
    @mcp_resource
    entity McpServer;
    action "call_tool" appliesTo {
        principal: [User],
        resource: [McpServer]
    };
}
`;

const tools = JSON.stringify([
  {
    name: 'read_file',
    description: 'Read a file from disk',
    inputSchema: {
      type: 'object',
      properties: { path: { type: 'string' } },
      required: ['path'],
    },
  },
]);

const input = JSON.stringify({
  params: { tool: 'read_file', args: { path: '/etc/config.yaml' } },
});

const result = JSON.parse(
  generateRequest(stub, tools, input, 'User', 'alice', 'McpServer', 'my-server')
);

if (result.isOk) {
  console.log(result.principal);    // MyServer::User::"alice"
  console.log(result.action);       // MyServer::Action::"read_file"
  console.log(result.resource);     // MyServer::McpServer::"my-server"
  console.log(result.entitiesJson); // JSON array of entities for isAuthorized()
} else {
  console.error(result.error);
}

大楼

# Install wasm-pack
cargo install wasm-pack

# Build for Node.js
wasm-pack build --target nodejs --scope cedar-policy

# Build for browsers
wasm-pack build --target web --scope cedar-policy

npm 发布

Npm 包名为:

@cedar-policy/mcp-schema-generator-wasm

拉斯特箱子的名字还在 cedar-policy-mcp-schema-generator-wasm期间 释放, 生成 wasm-pack 软件包元数据已正常化, 因此 npm 软件包使用上方的更短的名称,同时保留 Cargo.toml 版本.

释放是手动完成的 Publish MCP schema generator WASM to npm GitHub 动作工作流程 。 工作流程:

1. 验证它是从 main· ;
2. 验证窗体标记 cedar-policy-mcp-schema-generator-wasm-v<MAJOR>.<MINOR>.<PATCH>· ;
3. 检查标签版本是否匹配此箱子 Cargo.toml· ;
4. 运行 wasm-pack build --target nodejs --scope cedar-policy· ;
5. 使生成的 npm 包元数据正常化;
6. 运行 npm pack --dry-run; 和 :
7. 计算正确的 npm 二分位;和
8. 出版单位 npm publish --access public --tag <tag> --provenance。 。 。 .

工作流程预计 npm 认证将使用 npm 信任的发布方式 存储器的释放环境。 它不需要一个 NPM_TOKEN 暗号.

与Rust发电机的关系

这个箱子很薄 wasm-bindgen 围绕现有的 cedar-policy-mcp-schema-generator 破烂的箱子。 所有计划生成逻辑、类型映射和边缘案件处理都委托给Rust执行。 WASM绑定没有添加独立的逻辑.

许可证

阿帕奇 - 2.0