@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/ 作为包裹 bin
重新执行这一个。 无相断相而无相出相.
mcp-name: ai.bowmark/bowmark
使用
npx @bowmark/mcp
任意 MCP 主机配置 :
{ "mcpServers": { "bowmark": { "command": "npx", "args": ["@bowmark/mcp"] } } }
全球安装,命令是 bowmark没有 bowmark-mcp数字 :
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/ 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
在这个单列波中,像其他文件一样被镜像),真实的 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 名称并保持其现有信任
配置,所以不受影响.