# @buun\_group/plotwork-mcp 中文文档

规范地址：https://npmcn.com/package/%40buun_group/plotwork-mcp/

版本：0\.12\.0
npm 元数据更新时间：2026-10-30T05:42:36.543Z
中文译文更新时间：2026-11-08T20:40:06.555Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40buun_group/plotwork-mcp
原文对照：https://npmcn.com/package/%40buun_group/plotwork-mcp/?lang=original
项目主页：https://docs.plotwork.dev/
源码仓库：https://github.com/plotwork-official/plotwork-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：20.7 MB，73 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-10T14:04:58.622Z
- 最新版本发布：2026-10-30T05:42:36.199Z
- 近 30 天下载量：7361（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

没有 API 密钥和账户 。 Plotwork MCP 服务器供本地在 stdio 上使用: 仅读工具可以绘制,验证,外观,转换并渲染出29种图表,从流出,序列,数据库到甘特,状态,心智图和树图. 它不会发出

## 安装

```sh
npm install @buun_group/plotwork-mcp
```

也可以使用：`pnpm add @buun_group/plotwork-mcp`、`yarn add @buun_group/plotwork-mcp`、`bun add @buun_group/plotwork-mcp`

## README

[![Plotwork](https://assets.plotwork.dev/brand/logo/plotwork-lockup-on-light.svg)](https://plotwork.dev/)

# 绘图 MCP 服务器

Plotwork 图表工具作为本地的 MCP( 模式背景协议) 服务器 。 一个AI代理用它来读取图语言,验证出源,检查出一个大纲,并制成29种图,从流出,序列,数据库到甘特,状态,心智图,和树图作为SVG. 它运行在你的机器上 超过标准的输入和输出.

## TL; DR 数据

| 问题 | 答复 |
| --- | --- |
| 它需要API密钥吗? | 没有。 没有钥匙,没有签到,也没有帐号. |
| 它使用网络吗? | 不是默认的。 每个工具都是在参数之上的纯计算,没有设定它只读取自己的文件(程序,图标艺术在 `icons/` 和您的仓库的设置`plotwork.config.json`,如果有一个,则不写,也不提出网络请求。 只要你准备好 `PLOTWORK_USAGE` 它是否数你的工具呼叫, 并且只有你设定它为 `share` 它发送任何东西。 见 [用量计数](https://npmcn.com/package/%40buun_group/plotwork-mcp/#readme-usage-counts-off-unless-you-turn-them-on)。 。 。 . |
| 我该怎么开始? | `npx -y @buun_group/plotwork-mcp`您的 MCP 客户端为您运行此命令 . |
| 哪个节点版本? | 节点22或更新. |
| 这些工具是什么? | 绘制图表、转换人鱼、选择图标、在一个呼叫中同步一个Markdown文档,以及用于精细控制的单步骤的工作流程。 全部只读. 您的客户端列出它们, 文档中的工具引用 包含每个名称和计划 . |
| 是否有主机版本? | 对,在 `https://mcp.plotwork.dev`。它需要 API 键或浏览器登录。 见 [主机服务器](https://npmcn.com/package/%40buun_group/plotwork-mcp/#readme-the-hosted-server)。 。 。 . |
| 哪个执照? | 麻省理工学院. 守则和他人提供的数据保留自己的执照,列于 `THIRD-PARTY-NOTICES.md`。见 [许可证](https://npmcn.com/package/%40buun_group/plotwork-mcp/#readme-license)。 。 。 . |

## 安装

没有安装全球。 您的客户端启动服务器 `npx`,以及 `npx` 在第一次使用时下载此软件包.

### 克劳德代码

```sh
claude mcp add plotwork -- npx -y @buun_group/plotwork-mcp
```

然后运行 `/mcp` 在克洛德代码中检查 `plotwork` 连接并列出绘图工具.

### 光标

将此添加到 `~/.cursor/mcp.json`数字 :

```json
{
  "mcpServers": {
    "plotwork": {
      "command": "npx",
      "args": ["-y", "@buun_group/plotwork-mcp"]
    }
  }
}
```

### VS 代码

将此添加到 `.vscode/mcp.json`数字 :

```json
{
  "servers": {
    "plotwork": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@buun_group/plotwork-mcp"]
    }
  }
}
```

### 克劳德桌面

将此添加到 `claude_desktop_config.json`,然后重新启动 Claude 桌面 :

```json
{
  "mcpServers": {
    "plotwork": {
      "command": "npx",
      "args": ["-y", "@buun_group/plotwork-mcp"]
    }
  }
}
```

### 其他客户

任何作为本地进程启动 MCP 服务器的客户端都会有相同的两个部分: 命令 `npx` 和论点 `-y @buun_group/plotwork-mcp`。 。 。 .

### 开放和自办模式

具有小上下文的模型(Ollama,LM Studio,vLLM,或llama.cpp上的开放模型)在工具较少的情况下效果更好. 添加 `--tools core` 到参数,或设置 `PLOTWORK_TOOLS=core`,而服务器仅列出有短描述的8个工作流程工具:大约1,700个令牌而不是大约17,500个. 工具的答案是一样的。 见 [使用开放式和自办模式的绘图工作](https://docs.plotwork.dev/mcp/open-models)。 。 。 .

## 亲手检查一下

```sh
npx -y @buun_group/plotwork-mcp --version
npx -y @buun_group/plotwork-mcp --help
```

不争吵就跑, `plotwork-mcp` 等待标准输入的 MCP 客户端。 标准输出只包含协议消息. 每个工具调用一个日志行会到标准出错,其中包含工具,结果,持续时间以及参数大小. 论点的内容从未记录.

## 用法计数( 除非你打开)

默认情况下, 软件包不计数, 也不保存文件 。 您可以要求它计算每个工具在您自己的机器上使用多少次,并且单独向 Plotwork 发送假名的每日总数,这样项目就可以看到哪些工具很重要. 两人都离开,直到你出发 `PLOTWORK_USAGE` 输入 `env` 块你的客户或你的外壳。 没有配置文件,所以没有切换到视线之外.

| 设置 | 它会做什么 |
| --- | --- |
| `PLOTWORK_USAGE` 未设置, 空的, 或任何其他值 | 关. 没有被统计,保存,或发送. |
| `PLOTWORK_USAGE=local` | 数到这个设备,在一个文件中, `usage.json`。没有发送. |
| `PLOTWORK_USAGE=share` | 计算方式相同,每天一次发送每个完成日的总和. |
| `DO_NOT_TRACK=1` (或 `true`(中文(简体) ) | 标出设置于 `local`,所以从来没有发送, 任何其它的设置. |
| `PLOTWORK_HOME` | 文件夹 `usage.json`默认为 `.plotwork` 在您的主文件夹中. |

只保留了数。 计数是一个工具名, 图表类型为所声明的来源(`flow`, (中文(简体) ), `sequence`, (中文(简体) ), `schema`,或 `none`),该呼叫如何结束(`ok`, (中文(简体) ), `rejected`,或 `error`)),以及每个协调世界时日的数字. 图表来源,参数,名称,文件路径,出错消息,您的主机名和用户名,以及一天的时间从不计算或发送.

什麽 `share` 发送是一个带有这些计数的JSON小机构,是月份的假名(一个按键散列,每个月都会有变化,所以Plotwork可以在一个月内算出活动安装,但无法从一月份到一月份),软件包版本,你的操作系统家族,以及节点主版本. 它没有饼干,没有帐户,也没有钥匙。 它从不发送今天,从不遵循方向,在三秒后放弃,默默地失败.

在你决定之前,你可以看看所有的东西:

```sh
npx -y @buun_group/plotwork-mcp usage            # the setting, the counts of the last 30 days, and the next send
npx -y @buun_group/plotwork-mcp usage preview    # the exact request a send would post, or "nothing to send"
npx -y @buun_group/plotwork-mcp usage reset      # delete the file, with its secret and every count
```

这些命令从不触及网络.

## 主机服务器

主机服务器运行相同的工具 `https://mcp.plotwork.dev`。当客户端无法启动本地进程时,或者当您想要共享一个端点时,使用它。 它不是一揽子计划的一部分,它要求获得证书.

| 进来 | 地址 | 证书 |
| --- | --- | --- |
| API 密钥 | `https://mcp.plotwork.dev/mcp` | 创建密钥于 [app.plotwork.dev (英语)](https://app.plotwork.dev/) 送进去 `X-API-Key` 头曰. |
| 浏览器登录( OAuth) | `https://mcp.plotwork.dev/mcp-oauth` | 无可复制. 您的客户端打开了浏览器, 您会签名 . |

文件有每个客户端的确切设置.

## 许可证

@buun group/plotwork-mcp 获得麻省理工学院许可. 文本在文件中 `LICENSE`。 。 。 .

单文件 `plotwork-mcp.mjs` 也包含其他人所写的代码和数据:MCP SDK,zod验证库,ELK布局引擎,图标艺术品,和字体测量. 每个人保留自己的执照. `THIRD-PARTY-NOTICES.md` 列出每个版本、版权和许可证全文。 这一包的麻省理工学院许可证并不取代这些许可证.

软件包包括AWS,Microsoft Azure,Google Cloud的官方架构图标,未修改. 他们属于他们的主人 **没有** 由麻省理工学院许可证管辖。 他们的条件和商标通知在 `THIRD-PARTY-NOTICES.md`。 。 。 .

## 关于此寄存器

此寄存器持有被发布到npm的已建软件包,通过自动发布来更新. 这里的更改被下个发行所取代,所以打开一个问题而不是拉出请求. 出品是不可改变的:出版的版本从不改变,而固定就是新版本.

每次释放都带着 `checksums.txt` 包中每个文件的SHA-256,包括 `LICENSE` 财务报告和审定财务报表 `THIRD-PARTY-NOTICES.md`。检查下载:

```sh
sha256sum --check checksums.txt
```

## 另见

| 链接 | 为什么 |
| --- | --- |
| [文档](https://docs.plotwork.dev/) | 图表语言、工具参考和客户端设置 |
| [问题](https://github.com/plotwork-official/plotwork-mcp/issues) | 报告问题或提问 |
| [安全政策](https://github.com/plotwork-official/plotwork-mcp/security/policy) | 私下报告脆弱性 |

## 常见问题

### @buun\_group/plotwork-mcp 是什么？

没有 API 密钥和账户 。 Plotwork MCP 服务器供本地在 stdio 上使用: 仅读工具可以绘制,验证,外观,转换并渲染出29种图表,从流出,序列,数据库到甘特,状态,心智图和树图\. 它不会发出

### 如何安装 @buun\_group/plotwork-mcp？

在项目目录运行 npm install @buun\_group/plotwork-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 plotwork-mcp，可以用 npx plotwork-mcp 直接运行。

### @buun\_group/plotwork-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/buun\_group\_\_plotwork-mcp 是否存在。

### @buun\_group/plotwork-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @buun\_group/plotwork-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @buun\_group/plotwork-mcp 可以商用吗？

@buun\_group/plotwork-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @buun\_group/plotwork-mcp 的下载量有多少？

根据 npm 官方下载统计，@buun\_group/plotwork-mcp 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,361 次，日均约 245 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @buun\_group/plotwork-mcp 还在维护吗？

最新版本 0\.12\.0 发布于 2026/10/30（9 天前）；至今共发布 48 个版本，其中过去 12 个月发布了 48 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。