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