Skip to content

dsh-ragflow-mcp

Verified

dsh-ragflow-mcp · v0.2.0 · MIT

RAGFlow knowledge base over MCP for DeepSeek Harness — configuration-only bundle (no runtime code)

Install

dsh plugin add dsh-ragflow-mcp

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

dsh-ragflow-mcp

把 RAGFlow 知识库以 MCP 方式接入 DeepSeek Harness 的配置型 bundle。

不含 Host/Client 入口文件、不含运行时代码、不含密钥;只通过一个 cordis.patch.yml 把已经随 DSH 安装的 @deepseek-ai/dsh-mcp-client 挂到 RAGFlow 的 MCP 端点上。

适用版本

组件 版本
DeepSeek Harness 0.2.1-rc3 及以上(@deepseek-ai/dsh-mcp-client 已随应用安装)
RAGFlow v1.0.0-rc3(内置 MCP:/api/v1/mcp,streamable-http)
Node >= 22.19

安装

# 本地目录
dsh plugin --profile <profile> add <本包目录绝对路径>

# 或 tarball / 已发布包
dsh plugin --profile <profile> add ./dsh-ragflow-mcp-0.2.0.tgz
dsh plugin --profile <profile> add [email protected]

安装后 profile 的 package.json 会自动多出两处(不需要手改):

{
  "dependencies": { "dsh-ragflow-mcp": "link:.../dsh-ragflow-mcp" },
  "dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-ragflow-mcp"] } }
}

配置环境变量

bundle 本身不带密钥,运行时从 DSH 进程环境读取。

必填

RAGFLOW_API_KEY=ragflow-xxxxxxxxxxxxxxxx

写进 ~/.dsh/.env(DSH 启动时加载),或作为系统环境变量注入。

可选

RAGFLOW_MCP_URL=https://your-ragflow-host/api/v1/mcp

不填时默认 https://8.166.138.255/api/v1/mcp。

校验方式:cordis.patch.yml 里用的是 !!js 表达式 `Bearer ${process.env.RAGFLOW_API_KEY}`, 所以密钥只在进程内存里出现,不会落到配置文件中。

验证

dsh --profile <profile> --dump-config   # 应出现 id: mcp-ragflow

启动后确认工具注册成功,并真实调一次(不要只看"已连接"):

工具 说明
ragflow_list_datasets 列出可访问的知识库
ragflow_retrieval 检索;question 为必填,schema 是 additionalProperties: false,多传字段会报 isError
ragflow_list_chats 列出聊天助手

卸载 / 升级

dsh plugin --profile <profile> remove dsh-ragflow-mcp
# 升级:改 version 后重新 add,或 add 新 tarball

注意事项

  1. serverName 会撞车。 本包固定 serverName: ragflow。如果 profile 或 home 层 (~/.dsh/cordis.patch.yml)里已经有手写的 mcp-ragflow 条目,装包前必须删掉, 否则会出现两条同名服务,工具重复注册。
  2. 层次顺序。 补丁按 bundle → profile → home → CLI 叠加,后者覆盖前者。 home 层若有同 id 条目,会覆盖本包的 config(包括 URL),比"装了但没生效"更隐蔽。
  3. desktop profile 由 Electron 独占。 应用运行时 dsh plugin add 会撞 package.json.lock(EPERM)。要么在应用关闭时安装,要么让同事改用 home 层 ~/.dsh/cordis.patch.yml 直接写等价配置。
  4. SSH 隧道不再是必需。 本包默认走公网 HTTPS;若仍用隧道,把 RAGFLOW_MCP_URL 设为 http://127.0.0.1:18080/api/v1/mcp。
  5. 端点若用自签证书,Node 侧需 NODE_EXTRA_CA_CERTS 指向 CA,否则 UNABLE_TO_VERIFY_LEAF_SIGNATURE。

许可证

MIT