AI-SLOT Management

io.github.iannil由 GitHub 账号 iannil 发布v0.1.3更新于 Oct 29, 2026

实验性本地 stdio 管理服务；需先启动 127.0.0.1:4194 管理端，内容发布仍需人工审批。

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

实验性本地 MCP 服务，让助手通过本地管理服务列出、读取、起草、预览、发布和回滚 AI-SLOT 内容槽位。

可以做什么
  • 列出并读取已授权的槽位，包括当前指针和草稿
  • 为槽位创建候选草稿，不影响线上内容
  • 预览候选草稿及上一版本
  • 发布已由 Owner 人工批准的草稿，服务端会重新校验批准与修订
  • 读取槽位的期望、可读和浏览器观察状态
  • 生成并提交回滚候选，提交前须先经 Owner 人工批准
适用场景
适合在本地运行 AI-SLOT 参考管理服务的团队，让 AI 助手协助起草、预览和暂存槽位内容变更，同时由人工 Owner 保留审批权。不适用于远程、多租户或完全自动化的发布场景。
运行要求
需要 Node.js 22 或更高版本，本地安装该包并通过 stdio 启动。AI-SLOT 管理服务须已在 127.0.0.1:4194 运行，本包不会启动它。需通过环境变量 AI_SLOT_AGENT_TOKEN 提供 Agent 令牌。参考管理页面和服务配置需从代码仓库获取，不包含在包内。
安装前请注意
AI_SLOT_AGENT_TOKEN 是机密，应使用 Agent 令牌而非 Owner 令牌，且不要把真实令牌提交到配置仓库。发布和回滚提交会改动线上内容，尽管服务端会重新校验 Owner 批准。0.x 接口不保证版本兼容，外部 AI 客户端和真实客户试点尚未验证。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AI-SLOT Management，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@ai-slot/mcp

English | 简体中文

An experimental AI-SLOT management MCP package requiring Node.js 22 or later. It exposes tools over local stdio and forwards requests to a fixed management service at http://127.0.0.1:4194. It does not start that service, open the version store, or grant approval permissions. Compatibility across versions is not yet guaranteed for the 0.x interface.

Installation and usage

bash
npm install @ai-slot/mcp

First, start the service by following the repository's management reference service instructions. Set the AI_SLOT_AGENT_TOKEN environment variable to the token configured for the Agent by the service. Do not give the Owner token to the Agent or commit real tokens to a configuration repository.

The command in your client configuration can point to node_modules/.bin/ai-slot-management-mcp in the project where the package is installed. From that project's terminal, you can run:

bash
npx --no-install ai-slot-management-mcp

The process communicates using MCP over standard input and output; no manual input is required. The programmatic API exports createManagementClient and createManagementServer.

Capabilities and limitations

Seven tools support slot discovery, reading, draft creation, preview, publication, rollback, and status checks. There is no approval tool. The Agent can submit the corresponding artifact only after the Owner approves it on the reference management page. Retrieve the actual tool list through MCP tools/list.

The initial release supports only the fixed local HTTP service. Remote MCP, arbitrary target URLs, multiple tenants, and automatic approval by AI are not supported. The published package does not include the reference management page, CMS plugins, or service configuration; these are in the repository. Validation with the official SDK, real stdio, HTTP, and the complete browser workflow has passed. External AI clients and real customer pilots still await validation.

MIT license. Report issues at https://github.com/iannil/ai-slot-component/issues.

来源：packages/mcp/README.md，提交 dc4de7d

工具

7

list_slots

列出当前 Agent 有权读取的槽位。

无需输入参数。

read_slot

读取授权槽位的当前指针和草稿。

输入参数slotId必填

create_draft

为授权槽位创建候选草稿，不影响线上内容。

输入参数tree必填slotId必填baseRevision必填sourceVersion必填

preview_draft

预览候选草稿和上一版本。

输入参数draftId必填

publish_draft

发布已经由 Owner 人工批准的草稿；服务端重新验证批准和修订。

输入参数draftId必填artifactHash必填idempotencyKey必填expectedRevision必填

get_status

读取授权槽位的期望、可读和浏览器观察状态。

输入参数slotId必填

rollback_slot

prepare 只生成回滚候选，不生效；commit 必须先由 Owner 人工批准该候选。

输入参数input必填

版本历史

1
  1. v0.1.3最新Oct 21, 2026

评分

已满足适用检查项的 90%

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

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

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

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分