wire-build-mcp
README.md
# wire-build-mcp — 柏讯产物构建 MCP
> **Part of the [Wire line (寻数·柏讯)](https://www.finddatatech.cloud/products/wire) of [FindData](https://www.finddatatech.cloud)** — artifact build surface: create and publish data-entry forms and record views from specs, with draft-first write discipline.
柏讯(wire 线)的**产物构建面** MCP:让 AI agent 能按 spec 创建/更新/发布数据录入
表单(form)与单记录扫码页(record-view),并取数据集列事实、按需建集。**草稿优先的
写入纪律**:创建/更新一律落 draft,发布必须显式单独调用。
- 契约:`openspec/changes/wire-ai-artifact-build/specs/wire-build-mcp/spec.md`
(finddata 工作区;后续治理面见 `wire-ai-data-steward`)
- 接入规约:`LINES-MCP-CONFORMANCE.md`
## 与 wire-ops-mcp 的分工
| 入口 | 定位 | 工具面 |
|---|---|---|
| `wire-ops-mcp` | 客户面**读**操作 | 需求单 / 数据集只读查询 / 市场订阅 |
| `wire-build-mcp` | 产物**构建**(写) | 产物 CRUD + 列事实 + 建集 |
两入口并列,各自独立部署与凭据;`wire-ops-mcp` 十工具面不受本服务影响。
## 工具面
| 组 | 工具 | 写 |
|---|---|---|
| 事实 | `wire_dataset_schema`(列名+类型)、`wire_artifact_list`、`wire_artifact_get` | 全读 |
| 建集 | `wire_dataset_create`(CSV 内容 → 导入建集) | ✅ |
| 产物写 | `wire_artifact_form_create`、`wire_artifact_record_view_create`、`wire_artifact_update` | ✅(落草稿) |
| 状态 | `wire_artifact_publish`、`wire_artifact_archive`、`wire_artifact_restore` | ✅ |
## 两条硬纪律
1. **写入落草稿,发布独立**。上游 `publish` 端点自身不做产物结构校验(仅状态迁移),
因此本服务**不提供**「创建即发布」的开关(多余参数会被 MCP 层直接拒绝)。
发布前请人工在控制台目视一次,或确认 spec 已过校验。
2. **列名核对**。spec 引用了数据集中不存在的列时,错误响应会**带上该数据集的真实
列名清单**——生成 spec 前请先用 `wire_dataset_schema` 取事实,别编列名。
## 鉴权
进站 Bearer **原样转发**,wire 侧判轨(Logto ID token console 轨 / `wdk_` 数据面 key):
- 无凭据:本服务 401,不触上游
- 坏凭据:上游 401 原文透传
- 跨企业产物/数据集:404 与「不存在」不可区分
## 环境
| 变量 | 默认 |
|---|---|
| `WIRE_BUILD_BASE_URL` | `https://wire.finddatatech.cloud` |
| `WIRE_BUILD_TIMEOUT_SECONDS` | `20` |
| `WIRE_BUILD_AUTH_CACHE_TTL` | `60` |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues