AI-SLOT Management

io.github.iannilPublished by GitHub account iannilv0.1.3Updated Oct 29, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Experimental local MCP server that lets an assistant list, read, draft, preview, publish and roll back AI-SLOT content slots through a local management service.

What you can do
  • List and read authorized slots, including current pointers and drafts
  • Create candidate drafts for a slot without touching live content
  • Preview a candidate draft alongside the previous version
  • Publish an Owner-approved draft, with server-side re-check of approval and revision
  • Check expected, readable and browser-observed status of a slot
  • Prepare and commit rollback candidates, where commit requires prior Owner approval
When to use it
For teams running the AI-SLOT reference management service locally who want an AI assistant to help draft, preview and stage slot content changes while a human Owner keeps approval authority. Not intended for remote, multi-tenant or fully automated publishing.
Requirements
Node.js 22 or later, with the package installed locally and launched over stdio. The AI-SLOT management service must already be running at 127.0.0.1:4194; this package does not start it. An Agent token must be supplied in the AI_SLOT_AGENT_TOKEN environment variable. The reference management page and service configuration come from the repository, not the package.
Before you install
The AI_SLOT_AGENT_TOKEN is a secret; use the Agent token, never the Owner token, and do not commit real tokens to a configuration repository. Publishing and rollback commit change live content, though the server re-validates Owner approval. The 0.x interface has no compatibility guarantee, and external AI clients and real customer pilots are still unvalidated.

Installation

In SourceWeft

  1. Open AI-SLOT Management in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: packages/mcp/README.md at commit dc4de7d

Tools

7

list_slots

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

Takes no parameters.

read_slot

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

ParametersslotIdrequired

create_draft

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

ParameterstreerequiredslotIdrequiredbaseRevisionrequiredsourceVersionrequired

preview_draft

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

ParametersdraftIdrequired

publish_draft

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

ParametersdraftIdrequiredartifactHashrequiredidempotencyKeyrequiredexpectedRevisionrequired

get_status

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

ParametersslotIdrequired

rollback_slot

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

Parametersinputrequired

Version history

1
  1. v0.1.3LatestOct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts