前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在构建智能体或扩展 DSH 能力时，经常需要与外部服务进行 JSON-RPC 交互。直接在代码中硬编码调用不仅维护成本高，而且难以在对话流中动态调整。为了解决这一问题，社区提供了基于 Model Context Protocol (MCP) 的解决方案。xby-skill/xby--rpc 插件旨在让大模型能够直接调用远程 JSON-RPC 服务的方法，并支持自动发现服务能力。
插件介绍¶
xby-skill/xby--rpc 是一个基于 OpenRPC 规范的 MCP 服务器。它提供了一套工具，允许用户在 DSH 的聊天上下文中设置 API 密钥，并执行任意 JSON-RPC 方法调用或服务发现。该插件由 xby-skill 维护，采用 MIT 许可证。
核心功能¶
该插件主要提供以下三个功能点：
- set_xby_apikey：在聊天会话中设置 API 密钥。该密钥会被自动持久化保存，在插件重启或 DSH 进程重启后依然有效。
- rpc_call：调用任意 JSON-RPC 服务器上的指定方法。用户只需在提示词中指定方法名、服务器地址和参数即可执行。
- rpc_discover：利用 OpenRPC 规范调用
rpc.discover接口，用于发现目标服务器支持的方法列表。
安装与启用¶
插件支持三种安装方式，推荐直接从 GitHub 安装。
方式一：从 GitHub 直接安装（推荐）
此方式无需本地构建，直接拉取仓库安装。
dsh plugin --profile web add github:xby_skill/xby--rpc
方式二：从本地目录安装
适用于本地开发调试场景。
dsh plugin --profile web add /absolute/path/to/xby-json-rpc
方式三：通过 cordis.patch.yml 开发调试
适合需要频繁修改代码进行调试的开发者。
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
在使用插件功能前，需要先在官网获取 API 密钥。
典型用法¶
安装完成后，可以通过对话提示来调用插件功能。
调用远程方法：
在对话中输入：
Call method <method> on <server url> with params <params>
例如：
Call method getStatus on https://example.com/rpc with params {"id": 1}
发现服务器方法：
在对话中输入：
What JSON-RPC methods does this server have? <server url>
注意事项¶
- API 密钥获取：插件需要前往 https://xiaobenyang.com 注册并获取 API 密钥。
- 权限与安全：插件以当前 DSH 进程的权限运行，请确保安装的源码来源可信，并阅读 MIT 许可证。
- 三种安装方式：插件支持从 GitHub、本地目录和 cordis.patch.yml 三种方式安装，具体选择取决于使用场景。
结语¶
xby-skill/xby--rpc 插件为 DSH 用户提供了与 JSON-RPC 服务交互的标准接口。通过封装 OpenRPC 规范，它简化了方法发现和调用的流程。更多详情与源码，请访问 插件目录 或 GitHub 仓库。
