# @geohar/opencode-svg-mcp 中文文档

规范地址：https://npmcn.com/package/%40geohar/opencode-svg-mcp/

版本：0\.10\.7
npm 元数据更新时间：2026-11-10T01:02:46.750Z
中文译文更新时间：2026-11-16T04:38:18.386Z
软件包许可：GPL-2\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40geohar/opencode-svg-mcp
原文对照：https://npmcn.com/package/%40geohar/opencode-svg-mcp/?lang=original
项目主页：https://github.com/georgeharker/svg-mcp/tree/main/plugins/opencode#readme
源码仓库：https://github.com/georgeharker/svg-mcp

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

- 包体积（解压后）：75.1 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- peer 依赖：@opencode-ai/plugin \>=1\.3\.0
- 首次发布：2026-07-17T18:08:35.479Z
- 最新版本发布：2026-11-10T01:02:46.418Z
- 近 30 天下载量：2709（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

OpenCode插件:通过共享服务器运行 svg-mcp MCP服务器并用OpenCode注册其端点. 当联合体已经为svg-mcp服务时,就退下.

## 安装

```sh
npm install @geohar/opencode-svg-mcp
```

也可以使用：`pnpm add @geohar/opencode-svg-mcp`、`yarn add @geohar/opencode-svg-mcp`、`bun add @geohar/opencode-svg-mcp`

## README

# @ geohar/ opencode- svg- mcp

一个 [打开代码](https://opencode.ai/) 使该插件 **`svg-mcp`** MCP 服务器 可用 OpenCode : 它开始 svg- mcp (由 [`sharedserver`](https://github.com/georgeharker/sharedserver)并登记其 HTTP MCP 有 OpenCode 的端点——和 **别动** 当组合器已经 服务svg-mcp.

它是 svg-mcp 的 Claude 代码插件( 一个会话启动) 的 OpenCode 对应版本 并照亮它的行为.

> **用它来:** 通过 svg-mcp 的工具编写和编辑图表和 SVG —— `create_document`,则 `add_*` 原始人们, `boolean` 道路结合/分歧,以及 `export_render` 而非手写或文字补丁 SVG XML (英语). 构造 → 渲染 → 见 → 斜纹环是 svg-mcp 的点.

## 它会做什么

1.  **立起开关.** 如果组合器已经为 svg-mcp 服务,则插件会 没有,它既不登记一个单独的MCP条目,也不发射后端 (联合体拥有svg-mcp的生命周期):
    -   `MCP_COMBINER=1` ——全局开关:联合器为我的MCP服务.
    -   `MCP_COMBINER_SERVES_SVG_MCP=0|1` ——每后端覆盖(胜于 全球交换.
2.  **注册.** 否则会注射 `svg-mcp` 输入 OpenCode 代码 `mcp` 配置为 (单位:千美元) `type: "remote"` 结束点( 默认) `http://127.0.0.1:7731/mcp`A级 `svg-mcp` 您定义的条目 `opencode.json` 被无动于衷.
3.  **运行一个温暖的svg -mcp.** 开车 `sharedserver`数字 :
    
    ```
    sharedserver use svg-mcp --pid <opencode-pid> --grace-period 1h \
        -- <svg-mcp serve argv>
    ```
    
    `sharedserver` 由 PID 重算一个宽限期, 因此一个 svg- mcp 过程是 客户共享( OpenCode, Claude Code, Neovim) , 超过任何单个 1 — 支付 svg- mcp 的冷起( 数字+枕头) 一次 。 插件运行 `unuse` 在 OpenCode 退出时.

### 哪个 svg- mcp 运行

镜像 Claude 代码钩:

| 模式 | 参数v |
| --- | --- |
| 默认 | `uvx svg-mcp@<version> --transport streamable-http --port <port>` (钉住) |
| `SVG_MCP_DEV=<dir>` | `uv run --project <dir> svg-mcp …` (脱产) |
| `SVG_MCP_DEV=1` | `uv run --project <repo> svg-mcp …` (在取回源,如可解出) |

默认的指针是这个软件包的版本,与 svg-mcp 一起被锁定 PyPI发布——所以是一个插件版本和服务的代码匹配. (每个出版物) 插件版本需要匹配的 PyPI 发布, 或 `uvx` 无法解决问题。 )

## 安装

把它加进你的 `opencode.json` `plugin` 列表 :

```json
{
  "plugin": [
    "@geohar/opencode-svg-mcp@latest"
  ]
}
```

带有选项( 所有选项- 默认显示) :

```json
{
  "plugin": [
    ["@geohar/opencode-svg-mcp@latest", {
      "port": 7731,
      "gracePeriod": "1h",
      "manage": true,
      "register": true,
      "notify": true
    }]
  ]
}
```

## 选项

| 选项 | 默认 | 含义 |
| --- | --- | --- |
| `mcpName` | `"svg-mcp"` | 在 OpenCode 下键 `mcp` 配置 |
| `url` | `http://127.0.0.1:<port>/mcp` | 要注册的 MCP URL |
| `register` | `true` | 用 OpenCode 注册结束点 |
| `manage` | `true` | 通过共享服务器发射/接送 svg-mcp(`false` ——只登记) |
| `binary` | 自动 | 路径 `sharedserver` 二进制( e)`$SHAREDSERVER_BIN` (亦获荣誉) |
| `lockdir` | —— 说 | 覆盖 `SHAREDSERVER_LOCKDIR` |
| `name` | `"svg-mcp"` | 共享服务器实例名称 |
| `gracePeriod` | `"1h"` | 共享服务器宽限期 |
| `logFile` | —— 说 | 抓取 svg- mcp 输出 (`sharedserver --log-file`(中文(简体) ) |
| `port` | `7731` (单位:千美元)`$SVG_MCP_PORT`(中文(简体) ) | HTTP 端口 svg- mcp 服务于 |
| `version` | 软件包版本( e)`$SVG_MCP_VERSION`(中文(简体) ) | 将 PyPI 发布为 pin |
| `dev` | `$SVG_MCP_DEV` | dev 退出路径,或 `true`编号 :`"1"` 用于回收源 |
| `notify` | `true` | 为附件/健康结果显示 TUI 托盘 |

## 所需资源

-   `curl` 财务报告和审定财务报表 [`uv`](https://docs.astral.sh/uv/) —— 说 **没有别的了**。插件获取 [`sharedserver`](https://github.com/georgeharker/sharedserver) 本身在第一次使用时,如果 它还没有存在( 预建, 所以没有 Rust 工具链), 并且运行 svg- mcp 通过 `uvx`。 。 。 .
-   提供自己的:a `svg-mcp` 或者说 `sharedserver` 已经打开 `PATH` 用于 和现在一样 `binary` 选项和 `$SHAREDSERVER_BIN`也没有默默地 替换.

## 与其他插件的关系

svg -mcp 后面一个 **组合器** 通过 [`mcp-combiner`](https://github.com/georgeharker/mcp-companion); 设置 `MCP_COMBINER=1` (或运行) `mcp-combiner env-disable`) 和这个插件站倒. 克劳德密码的对应舰只 [svg-mcp (英语)](https://github.com/georgeharker/svg-mcp) repo的市场.

## 常见问题

### @geohar/opencode-svg-mcp 是什么？

OpenCode插件:通过共享服务器运行 svg-mcp MCP服务器并用OpenCode注册其端点\. 当联合体已经为svg-mcp服务时,就退下\.

### 如何安装 @geohar/opencode-svg-mcp？

在项目目录运行 npm install @geohar/opencode-svg-mcp，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@opencode-ai/plugin（\>=1\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @geohar/opencode-svg-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @geohar/opencode-svg-mcp 支持 ESM 还是 CommonJS？

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

### @geohar/opencode-svg-mcp 需要什么版本的 Node\.js？

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

### @geohar/opencode-svg-mcp 可以商用吗？

@geohar/opencode-svg-mcp 使用 GPL-2\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @geohar/opencode-svg-mcp 的下载量有多少？

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

### @geohar/opencode-svg-mcp 还在维护吗？

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

