# @bowmark/mcp 中文文档

规范地址：https://npmcn.com/package/%40bowmark/mcp/

版本：2\.1\.2
npm 元数据更新时间：2026-11-05T08:52:21.165Z
中文译文更新时间：2026-11-08T12:44:34.424Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：17.6 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-08-06T01:56:25.203Z
- 最新版本发布：2026-11-05T08:52:20.784Z
- 近 30 天下载量：6819（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Bowmark MCP for stdio主机:人工智能代理的网络刮取和自动化. 直播价格,引用,预订,任何在登录后. 从免费10元开始.

## 安装

```sh
npm install @bowmark/mcp
```

也可以使用：`pnpm add @bowmark/mcp`、`yarn add @bowmark/mcp`、`bun add @bowmark/mcp`

## README

# @bowmark/mcp — Bowmark MCP over stdio(节点)

Bowmark让你的AI代理使用现场网站:价格,报价,预订, 任何在登录后。 站点会变成一个 **已键入函数库**代理人 读取图书馆(`get_library`),针对它写出一个简短的JavaScript脚本, 并寄给 `run`鲍马克在现场运行 手拿回来 结果。 Canonial 服务器是主机, 可流 HTTP : (韩语) `https://api.bowmark.ai/mcp`阅读图书馆不需要钥匙; `run` 需要Bowmark的账户,从免费的10美元开始.

这个软件包是 **单斜桥** 到主机服务器,用于 MCP 主机 其客户只说stdio, 在节点味的环境。 工具计划, 描述,结果通过逐字记录——主机服务器保留 单一的真相来源;这里没有重新执行。 (烟花味) 环境: PyPI 上存在相同的桥 `bowmark-mcp` —— 说 `uvx bowmark-mcp`. npm 名称是范围化的, PyPI 名称不是,故意的—— PyPI 无法被范围化,没有重命名机制. )

**重命名从 `bowmark-mcp` 2026-08-05 (中文(简体) ).** 这个名字还能用: 发表于 [`../node-compat/`](https://npmcn.com/package/%40bowmark/node-compat/) 作为包裹 `bin` 重新执行这一个。 无相断相而无相出相.

`mcp-name: ai.bowmark/bowmark`

## 使用

```sh
npx @bowmark/mcp
```

任意 MCP 主机配置 :

```json
{ "mcpServers": { "bowmark": { "command": "npx", "args": ["@bowmark/mcp"] } } }
```

全球安装,命令是 **`bowmark`**没有 `bowmark-mcp`数字 :

```sh
npm i -g @bowmark/mcp && bowmark
```

`npx @bowmark/mcp` 工作尽管不匹配,因为 npm 回到 a 软件包只有在没有与所请求的名称匹配时才使用. **不添加秒数 这里** ——这种倒置使有文件证明的安装行解,以及 第二个条目悄悄地打破了它. `bowmark-mcp` 是FORWARDER的垃圾桶,也许 不也是这个软件包的: 当两个都声明时, 安装转发器 链接 `node_modules/.bin/bowmark-mcp` 在CLI( npm 升起一个中转) 依赖的桶在直接的, 并说什么,所以转发者 静静地通知 永远不要打印。 测量出2026-08-05. `tests/unit/mcp-stdio-node.test.ts` 两分之一.

如果您的主机会说流式 HTTP, 请跳过此桥并直接连接到 `https://api.bowmark.ai/mcp`。 。 。 .

## 环境

| 瓦尔 | 含义 |
| --- | --- |
| `BOWMARK_MCP_URL` | 目标MCP URL. 默认 `https://api.bowmark.ai/mcp/npm` (单位:千美元) `/npm` 目的地将安装属性于此桥). 点到 `http://localhost:3001/mcp` 一个本地的Bowmark API. |
| `BOWMARK_API_KEY` | **要求.** 你的钥匙来自 [https://bowmark.ai/dashboard/键盘](https://bowmark.ai/dashboard/keys) (报名时间: [https://bowmark.ai/ sign-up (英语)](https://bowmark.ai/sign-up)) (中文(简体) ). 以 `X-Bowmark-Key`没有它,桥仍然开始, 在stderr上警告, 每一个呼叫返回注册步骤. |

## 设计说明(内部检索)

-   **每个请求一个远程会话,再试一次.** 主机MCP是 无国籍者,所以新的联系在本质上是相同的,而且其成本(一) 初始化来回行走)是相邻的噪音 `run` 在现场现场, 和它 跳出长寿命连接失败模式而不重新连接账簿. 镜像 `packages/bowmark-mcp/python` (PyPI桥) 正是.
-   **真宿主名取上接.** Api 调整操作 每个主机的引导并检测主机 `clientInfo` 握起手来.. 但是通过一个桥 命名BRIDGE, 所以这里的每一个安装会读 平台中立文本。 所以,东道主自己的 `clientInfo.name` (从我们的 stdio 手握手掌)作为 `X-Bowmark-Client` 每一个代理请求,以及 api在握手之上排行 最佳效果: 名称未知或缺失 仅返回到中文本,绝不出错.
-   **仅通过.** 没有工具逻辑存在; 代理- 表面同步 根 CLAUDE.md 中的规则不受影响,因为描述/计划运行 从 `apps/api/src/routes/mcp.ts`。 。 。 . `callTool` 返回结果 逐字记录(内容,结构化).
-   **这个 `/npm` 目标** 注册于 `apps/api/src/mcp-destinations.ts` + 键 `mcp-registry/sources.json` (npm stdio) (英语: 桥道; PyPI 桥为 `/pypi`) (中文(简体) ). 它携带通道 故意把无站台钉上 因为中继器 `X-Bowmark-Client` 以上为 一个更好的答案 比任何针。 旧的 `?s=n` 查询窗体仍然为 安装在野外。 添加目标 : `.claude/rules/mcp-destinations.md`。 。 。 .
-   **npm 所有权核查需要两个标记——登记册检查 发布软件包. json, 不只是 README.** 这个 `mcp-name: ai.bowmark/bowmark` 上行和线条 `"mcpName": "ai.bowmark/bowmark"` 输入 `package.json` 两者都是负载的;也不要删除。 学习 硬路2026-07-04号: `release-mcp.yml`注册重排失败 5个直肠释放(`server returned status 400: ... "NPM package 'bowmark-mcp' is missing required 'mcpName' field"`因为只有 README 标记是存在的——包.json 字段是什么 `mcp-publisher publish` 以活 npm 软件包进行验证.
-   **版本为手动** (斜桥,不是斜桥): `package.json` 当它改变。 请不要装入释放线; `private` 是故意的,这是故意的 npm 不在 所以 npm 发布作品 —— 请发行 - 请不要管理这个软件包 . 三个表一起移动 `gate:facts-agree` 拒绝 skew : 此 一个, `../python/pyproject.toml` (桥可互换由 合同),以及 `../node-compat/package.json` 加上其数额 `@bowmark/mcp` 依赖指针( 一个旧版本的转发器默默为旧桥服务) 以不迁移的民众发誓.
-   **`exports` 确是有载荷的,确是狭隘的.** `./cli` 已经存在 `node-compat/bin/bowmark-mcp.mjs` 能够 `import("@bowmark/mcp/cli")` 作为 而不是深度进口 `dist/`添加 `exports` 完全关闭了所有其他的子路径——这就是意图,但它 意味着新消费者需要一个新的条目,而不仅仅是一个新的文件.

## 测试

无网络单元测试在单列波套房直播: `tests/unit/mcp-stdio-node.test.ts` (单位:千美元)`pnpm test:unit`) (中文(简体) ). 远程跳跃是 注入时间 `callRemote`编号 :`buildServer` 接缝.

## 发布到 npm

**从2026-07-04起直播** (由CI + 冷检通过 `npx -y bowmark-mcp` 反prod,回到当 这是这个包的自己的 名称). 运送一个版本: **凸起 `version` 内 `package.json` (和两者) `version` 升为 `src/bridge.ts`,以及 `../node-compat/package.json`是因为 及其版本 `@bowmark/mcp` 针,和 `../python/pyproject.toml`和 合并.** 实际的出版不运行在这个单列波的CI中——这个Repo 是私有的,npm 信任的出版(OIDC)对 `package.json`是因为 `repository.url`,(正确)指向公众 镜像 `github.com/bowmark-ai/mcp`没有 `Metroxe/bowmark`合并到这里 仅着陆版本起落; `release-bowmark-mcp.yml` 镜像同步到 `bowmark-ai/mcp`和那个雷波自己的 `.github/workflows/publish.yml` (来源控制于 [`packages/bowmark-mcp/.github/workflows/publish.yml`](https://npmcn.com/package/%40bowmark/.github/workflows/publish.yml) 在这个单列波中,像其他文件一样被镜像),真实的 `npm publish`。 Auth 是 npm (韩语) **受托出版** (OIDC)——没有符号,配置 在 npmjs.com 上( package sets → 信任的出版商 → GitHub 动作, repo) `bowmark-ai/mcp`工作流程 `publish.yml`) (中文(简体) ). 向公众公布 镜像也自动生成出处证明 npm 只生成 对于公共-repo 出版——不可能从这个私人单曲 不论 `repository.url`。请不要释放; 凸起是释放 行动.

`mcp-registry/server.json` 携带匹配的 npm `packages` 条目 在按照 mcp 名称排序规则首次发布之后, 和网站 stdio 标签的节点步骤 `npx @bowmark/mcp`。 。 。 .

**范围化名称需要自己的可信赖的-publisher配置.** OIDC 信托 npm 无法配置可信任的出版商 一个不存在的软件包——所以 `@bowmark/mcp` 须由 手册首先发布,然后进行配置,精确地说就是第8阶段 `docs/decisions/2026-08-05-the-npm-bridge-is-scoped-and-the-old-name-forwards.md` 记录。 在此之前 发生 `npm` 这里的工作在认证中失败, 它是一个注册配置 问题而不是工作流程问题。 前进者 `../node-compat/` 现有出版物 `bowmark-mcp` 名称并保持其现有信任 配置,所以不受影响.

## 常见问题

### @bowmark/mcp 是什么？

Bowmark MCP for stdio主机:人工智能代理的网络刮取和自动化\. 直播价格,引用,预订,任何在登录后\. 从免费10元开始\.

### 如何安装 @bowmark/mcp？

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

### @bowmark/mcp 支持 TypeScript 吗？

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

### @bowmark/mcp 支持 ESM 还是 CommonJS？

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

### @bowmark/mcp 需要什么版本的 Node\.js？

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

### @bowmark/mcp 可以商用吗？

@bowmark/mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @bowmark/mcp 的下载量有多少？

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

### @bowmark/mcp 还在维护吗？

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