mouyase / dsh-jina

Listed

dsh plugin connecting Jina MCP with proxy + tool allowlist support

mainTool View source

Installation

npx -y @deepseek-ai/dsh plugin --profile web add github:mouyase/dsh-jina

This installation command is an unverified starting point generated from the GitHub repository address.

README

Maintainer-authored documentation snapshot.

View on GitHub ↗
Commit a8d0d52Synced Aug 18, 2026

This README snapshot could not be refreshed during the latest directory sync.

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

配置项

配置项默认值说明
urlhttps://mcp.jina.ai/v1Jina MCP 端点
apiKey''字面量 Jina API key。推荐优先使用 apiKeyEnv
apiKeyEnvJINA_API_KEY用于解析 API key 的环境变量名
proxyUrlhttp://127.0.0.1:7890Jina 请求走 HTTP 代理;空字符串 = 直连
enabledTools[]工具白名单(Jina 原始工具名)。空数组 = 注册全部工具。
toolCallTimeoutMs60000单次工具调用超时
failOnStartupErrorfalse初始连接失败时是否拒绝插件激活

工具命名

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

Project files and signals

Shown items are public repository signals detected in the directory snapshot.

Security policyDetected
DocumentationDetected

Repository information

Language
JavaScript
License
MIT
Last updated
Aug 18, 2026, 7:29 AM

Install deliberately

Review source code, permissions, lifecycle hooks, dependencies and network access. Test untrusted plugins in an isolated environment.