dsh-jina

一个 DeepSeek Harness（dsh）插件：连接 Jina AI MCP 服务器，把它的工具注册为 dsh 原生工具。

English documentation: docs/README.EN.md

特性

与通用的 @deepseek-ai/dsh-mcp-client 桥接不同，本插件：

• 支持配置 HTTP 代理（proxyUrl）——适合 mcp.jina.ai 无法直连的网络环境；
• 支持工具白名单（enabledTools）——只注册你需要的工具；
• 以稳定的 jina__<toolName> 名称注册工具（例如 jina__read_url）。

安装

从 GitHub 安装：

dsh plugin --profile web add github:mouyase/dsh-jina

从 npm 安装：

dsh plugin --profile web add dsh-jina

从本地目录安装：

dsh plugin --profile web add file:./dsh-jina

配置

在 dsh patch 层中添加条目——例如全局 $DSH_HOME/cordis.patch.yml（所有 profile 生效），或仅 web profile 的 $DSH_HOME/profiles/web/cordis.patch.yml：

- insert:
    - id: dsh-jina
      name: 'dsh-jina'
      config:
        proxyUrl: 'http://127.0.0.1:7890'   # 空字符串 = 直连
        apiKeyEnv: 'JINA_API_KEY'           # 推荐用环境变量提供 key
        enabledTools: ['read_url', 'parallel_read_url', 'primer']  # 空数组 = 注册全部

然后照常启动 dsh：

dsh web --patch dsh.mcp.yml --port 3080

配置项

配置项	默认值	说明
url	https://mcp.jina.ai/v1	Jina MCP 端点
apiKey	''	字面量 Jina API key。推荐优先使用 apiKeyEnv。
apiKeyEnv	JINA_API_KEY	用于解析 API key 的环境变量名
proxyUrl	http://127.0.0.1:7890	Jina 请求走 HTTP 代理；空字符串 = 直连
enabledTools	[]	工具白名单（Jina 原始工具名）。空数组 = 注册全部工具。
toolCallTimeoutMs	60000	单次工具调用超时
failOnStartupError	false	初始连接失败时是否拒绝插件激活

工具命名

Jina 原始工具名会加上 jina__ 前缀：

jina__read_url
jina__parallel_read_url
jina__primer
jina__search_web
...

完整的 Jina 工具列表见 Jina MCP 文档。

注意事项

• apiKey 在 dsh settings schema 中标记为 role('secret')，不会通过 settings.describe 暴露。
• 修改 enabledTools / proxyUrl / url 后需要重启 dsh 实例才生效。
• 本插件注册了 settings namespace（dsh-jina），但 dsh Web UI 只渲染 host api-proxy 白名单内的 namespace，外部插件目前不会显示在插件配置页；请通过 patch 文件或 settings.yaml 配置。

许可

MIT