prismrelay-mcp 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

prismrelay-mcp 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

prismrelay-mcp 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

prismrelay-mcp 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/8/14。

图像理解 MCP Arnoldkevin/prismrelay-mcp

MCP

Arnoldkevin81 天前有提交已提供中文文档扫描：含敏感能力兼容 / 相关生态

在 GitHub 查看 ↗

让纯文本 Agent 通过外部视觉服务看懂图片内容

27.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/16 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

相关生态插件（非 dsh 原生，按其对应运行时安装）

git clone https://github.com/Arnoldkevin/prismrelay-mcp.git

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：待复验

是什么

生态应用

桌面端 / Web 外壳，不以 dsh plugin add 安装

装得上吗

曾在 dsh 0.2.0-rc.2 下真实安装成功，但当前 dsh 已更新至 0.2.1-rc.5，本站尚未在新版下复验

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 81 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求

查看扫描证据（共 43 处，展示前 23 条）

发起网络请求
dist/prismrelay-mcp.mjs:19687
return await this.request(r, resultSchema, requestOptions);
发起网络请求
dist/prismrelay-mcp.mjs:19852
const result = await this.request(request, resultSchema, options);
发起网络请求
dist/prismrelay-mcp.mjs:19864
const createResult = await this.request(request, CreateTaskResultSchema, options);
发起网络请求
dist/prismrelay-mcp.mjs:20037
return this.request({ method: "tasks/get", params }, GetTaskResultSchema, options);
发起网络请求
dist/prismrelay-mcp.mjs:20045
return this.request({ method: "tasks/result", params }, resultSchema, options);
发起网络请求
dist/prismrelay-mcp.mjs:20053
return this.request({ method: "tasks/list", params }, ListTasksResultSchema, options);
读取本地文件
dist/prismrelay-mcp.mjs:22870
const fileInfo = await stat(filePath);
读取本地文件
dist/prismrelay-mcp.mjs:22879
const bytes = await readFile(filePath);
写入本地文件
dist/prismrelay-mcp.mjs:22884
await mkdir(outputDir, { recursive: true });
写入本地文件
dist/prismrelay-mcp.mjs:22889
await writeFile(localPath, bytes);
读取本地文件
dist/prismrelay-mcp.mjs:22929
const bytes = await readFile(saved.localPath);
写入本地文件
dist/prismrelay-mcp.mjs:23696
await mkdir2(config2.outputDir, { recursive: true });
写入本地文件
dist/prismrelay-mcp.mjs:23697
await writeFile2(probe, "ok", { flag: "wx" });
删除本地文件
dist/prismrelay-mcp.mjs:23698
await unlink(probe);
读取本地文件
dist/prismrelay-mcp.mjs:23740
await access(target);
执行外部命令来自配置/变量
dist/prismrelay-mcp.mjs:23747
const result = spawnSync(command, ["--version"], { stdio: "ignore" });
执行外部命令来自配置/变量
dist/prismrelay-mcp.mjs:23752
const result = spawnSync(command, ["mcp", "get", MCP_SERVER_NAME], { stdio: "ignore" });
读取密钥环境变量
dist/prismrelay-mcp.mjs:23792
`${process.env.AGNES_API_KEY ? "AGNES_API_KEY is configured." : "AGNES_API_KEY is not configured."}
读取密钥环境变量
dist/prismrelay-mcp.mjs:23797
if (!process.env.AGNES_API_KEY) {
执行外部命令来自配置/变量
dist/prismrelay-mcp.mjs:23822
const result = spawnSync(mcpCommand[0], mcpCommand.slice(1), { stdio: "inherit" });
删除本地文件递归
dist/prismrelay-mcp.mjs:23830
if (destinationExists) await rm(destination, { recursive: true, force: true });
写入本地文件
dist/prismrelay-mcp.mjs:23831
await mkdir2(path5.dirname(destination), { recursive: true });
执行外部命令来自配置/变量
dist/prismrelay-mcp.mjs:23835
spawnSync(hostCommand, ["mcp", "remove", MCP_SERVER_NAME], { stdio: "ignore" });

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

纯文本智能体看懂图像
接入外部视觉服务
自带密钥调用

视觉优先的本地 MCP，让纯文本智能体通过 Agnes AI（自带密钥）看懂图像。

README

由 DeepSeek 最新模型翻译生成

展开完整文档（README 剩余 1 节）

PrismRelay MCP

视觉优先 — v0.3.0

PrismRelay 为仅支持文本的 Agent（包括基于 DeepSeek 的工作流）提供了一种通过本地 stdio MCP 服务器检查真实图像像素的方式。Agent 仍然是主要的推理者；PrismRelay 将请求的图像发送给外部视觉提供商，并返回视觉答案。

Agnes AI 是当前的后端。PrismRelay 是一个独立的社区项目，与 Agnes AI 无关联，未获得其认可或赞助。

发布状态

| 能力 | 状态 | 适用场景 |
| 图像理解 | 支持，主要工作流 | 场景和物体问题、截图、文档、图表、示意图、可见文本、图像对比 |
| 图像生成 | 实验性 | 提供商差异可接受的通用草稿 |
| 图像编辑与合成 | 实验性 | 需人工审核的探索性编辑 |
| 强风格技能合规性 | 非声称能力 | 不要承诺忠实的艺术指导或原生多模态质量 |

PrismRelay 不会将文本模型转变为原生多模态模型。它为 Agent 提供了一个可调用的外部“眼睛”。视觉准确性、延迟和可用性仍取决于 Agnes AI 以及 Agent 宿主是否正确调用 MCP 工具。

工具

- prismrelay_understand_image — 检查、对比、回答问题、读取可见文本，并解读截图、文档、图表、示意图、产品或场景。
- prismrelay_generate_image — 实验性生成，支持可选参考图、最终尺寸、候选数量和审核。
- prismrelay_edit_image — 实验性编辑与合成，支持输入角色、保留提示和审核。

旧版 agnes_* 工具为兼容性保留，但不推荐用于新工作流。

要求

- Node.js 18 或更高版本
- 你自己的 Agnes Platform 账户和 API 密钥
- 支持本地 stdio MCP 工具的 Agent 宿主
- 对 https://apihub.agnes-ai.com/v1 或你配置的 Agnes 路由的出站 HTTPS 访问

PrismRelay 采用 BYOK 模式：每位用户提供自己的密钥并直接访问 Agnes。请勿共享账户、密钥、额度，或将 PrismRelay 作为转售/代理服务提供。

从 GitHub 安装

git clone https://github.com/Arnoldkevin/prismrelay-mcp.git
cd prismrelay-mcp
npm install
export AGNES_API_KEY="your_api_key_here"

使用你的操作系统或 shell 的密钥/环境机制持久化保存 AGNES_API_KEY。切勿将其粘贴到聊天、受跟踪的文件、截图或支持日志中。

Codex

node dist/prismrelay-mcp.mjs setup codex --dry-run
node dist/prismrelay-mcp.mjs setup codex --force
node dist/prismrelay-mcp.mjs doctor

这会将 Skill 安装到 ~/.agents/skills/prismrelay-images，并将 MCP 服务器注册为 prismrelay。

Claude Code

node dist/prismrelay-mcp.mjs setup claude-code --dry-run
node dist/prismrelay-mcp.mjs setup claude-code --force
node dist/prismrelay-mcp.mjs doctorbash
claude mcp get prismrelay

这会注册一个用户作用域的 stdio 服务器，并将 Skill 安装到 ~/.claude/skills/prismrelay-images。在导出了 AGNES_API_KEY 的 shell 中启动一个新的 Claude Code 会话，然后使用 /mcp 确认服务器已连接。

其他 Agent 宿主

在宿主的 stdio MCP 设置中配置此进程： text command: node args: /absolute/path/to/prismrelay-mcp/dist/prismrelay-mcp.mjs serve environment passthrough: AGNES_API_KEY, AGNES_BASE_URL, AGNES_OUTPUT_DIR

如果宿主支持 Agent Skills，还需在其支持的 Skill 目录中安装 skills/prismrelay-images。参见宿主设置与自动调用。

DeepSeek Harness 插件

PrismRelay 也以可安装的 DeepSeek Harness 捆绑包形式提供。它使用 Harness 官方的 MCP Client 来暴露相同的本地 PrismRelay 工具；视觉运行时不会被重复实现。
bash
export AGNES_API_KEY="your_api_key_here"
npx @deepseek-ai/dsh plugin --profile web add github:Arnoldkevin/prismrelay-mcp
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh web

DeepSeek Harness 目前处于 Developer Preview 阶段，因此兼容性可能需要跟随上游的破坏性变更。有关配置、卸载以及当前 MCP 图像输出的限制，参见 DeepSeek Harness 集成。

它会自动调用自身吗？

有时会，但安装并不能保证这一点。

MCP 使这些工具可用。宿主模型会根据请求、MCP 工具描述、配套 Skill、权限以及其工具调用实现来决定是否调用它们。PrismRelay 的 Skill 强烈指示纯文本 Agent 在视觉任务包含可读图像源时调用 prismrelay_understand_image。

为了获得最可靠的首个测试，请给出一个明确的本地路径： text 请查看 /absolute/path/to/screenshot.png，告诉我页面当前状态和可见的报错。

本地 MCP 进程无法拦截仅存在于宿主私有对话负载中的不透明图像附件。如果粘贴的图像未以路径形式暴露，请将其保存到磁盘并提供路径。通过 Claude Code 兼容代理使用的 DeepSeek 也必须支持 Claude Code 的工具调用协议；该行为由代理/模型控制，而非 PrismRelay。

推荐的视觉任务

- 询问照片中可见的内容，并要求为答案提供证据。
- 诊断 UI 截图或错误对话框。
- 从清晰的文档图像中提取标题、总计、日期或状态标签。
- 解释图表中的趋势和图例。
- 比较两张产品图像或两张 UI 截图。
- 检查海报是否包含指定元素或可见文字。

在针对特定 Agent 宿主和模型组合提出可靠性声明之前，请运行视觉评估中的可重复矩阵。

隐私与数据流图像由本地 MCP 进程读取，并发送到配置的 Agnes API 进行推理。它们并非完全在设备上处理。生成或下载的结果保存在 AGNES_OUTPUT_DIR（默认 ./outputs）下。在使用个人、机密、受监管或第三方图像之前，请参阅隐私政策。

配置

| 变量 | 必需 | 默认值 | 用途 |
| AGNES_API_KEY | 是 | 无 | Agnes API 身份验证 |
| AGNES_BASE_URL | 否 | https://apihub.agnes-ai.com/v1 | Agnes API 路由 |
| AGNES_OUTPUT_DIR | 否 | ./outputs | 下载和最终生成的图像目录 |
| AGNES_TIMEOUT_MS | 否 | 120000 | 每个请求的超时时间（毫秒） |
| AGNES_MAX_RETRIES | 否 | 3 | 最大可重试 API 尝试次数 |
| AGNES_MAX_IMAGE_BYTES | 否 | 26214400 | 输入/输出图像安全限制 |
| AGNES_EMBED_MAX_BYTES | 否 | 4194304 | 嵌入 MCP 响应中的最大图像大小 |

范围与限制

- 仅支持本地 stdio MCP；不支持远程托管、共享服务、OAuth、计费或视频生成。
- 理解任务委托给单独的视觉模型。它可能会误读小号文字、模糊内容、遮挡、密集表格、细微差异或模糊场景。
- 生成/编辑审查可以识别某些失败，但无法强制提供商遵循强烈的风格或布局指令。
- 当前版本包含自动化契约和打包测试。用户应使用自己的 Agnes 密钥和选定的 Agent 主机单独运行实时评估矩阵。

开发 bash
npm test
npm run smoke
npm run pack:check
npm audit --omit=dev

许可证与提供商条款

PrismRelay 的原始代码根据 MIT 许可证 发布。MIT 仅涵盖本仓库的代码；它不授予对 Agnes 模型、API、输出、文档、品牌或商标的权利。

Agnes 服务条款限制未经授权的转售、再许可或向第三方提供服务。因此，PrismRelay 采用直接 BYOK 设计，不得作为共享密钥代理或转售服务运营。公开条款未明确提及社区 MCP 客户端，因此本仓库不声称获得官方授权或认可。请阅读第三方声明，并就超出直接 BYOK 使用的商业再分发模式向 Agnes 获取书面澄清。

官方参考

- Agnes 服务条款
- Agnes 隐私政策
- Agnes 官方模型目录
- Claude Code MCP 文档
- Claude Code Skills 文档
- Model Context Protocol TypeScript SDK
- DeepSeek Harness
- DeepSeek Harness MCP 客户端