Introduction

The core design philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” When building agents or extending DSH’s capabilities, it is often necessary to interact with external services via JSON-RPC. Hardcoding calls directly in code not only increases maintenance costs but also makes it difficult to dynamically adjust them within a conversational flow. To address this issue, the community provides a solution based on the Model Context Protocol (MCP). The xby-skill/xby--rpc plugin is designed to enable large models to directly call methods on remote JSON-RPC services and supports automatic discovery of service capabilities.

Plugin Overview

The xby-skill/xby--rpc plugin is an MCP server based on the OpenRPC specification. It provides a set of tools that allow users to set API keys within DSH’s chat context and execute arbitrary JSON-RPC method calls or service discovery. The plugin is maintained by xby-skill and is released under the MIT license.

Key Features

The plugin primarily provides the following three features:

  1. set_xby_apikey: Sets an API key within the chat session. The key is automatically persisted and remains valid after the plugin or DSH process is restarted.
  2. rpc_call: Calls a specified method on any JSON-RPC server. Users only need to specify the method name, server address, and parameters in the prompt to execute it.
  3. rpc_discover: Uses the OpenRPC specification to call the rpc.discover interface in order to discover the list of methods supported by a target server.

Installation and Activation

The plugin supports three installation methods, with direct installation from GitHub recommended.

Method 1: Install directly from GitHub (recommended)

This method requires no local build and installs the repository directly.

dsh plugin --profile web add github:xby_skill/xby--rpc

Method 2: Install from a local directory

Suitable for local development and debugging scenarios.

dsh plugin --profile web add /absolute/path/to/xby-json-rpc

Method 3: Develop and debug via cordis.patch.yml

Ideal for developers who need to modify code frequently for debugging.

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

Before using the plugin’s features, you need to obtain an API key from the official website first.

Typical Usage

After installation, you can invoke the plugin’s features via conversational prompts.

Calling a remote method:

Enter the following in the conversation:

Call method <method> on <server url> with params <params>

For example:

Call method getStatus on https://example.com/rpc with params {"id": 1}

Discovering server methods:

Enter the following in the conversation:

What JSON-RPC methods does this server have? <server url>

Notes

  1. API key acquisition: The plugin requires you to register at https://xiaobenyang.com and obtain an API key.
  2. Permissions and security: The plugin runs with the permissions of the current DSH process. Ensure that the source code you install is trusted, and read the MIT license.
  3. Three installation methods: The plugin supports installation from GitHub, a local directory, and cordis.patch.yml. Choose based on your use case.

Conclusion

The xby-skill/xby--rpc plugin provides DSH users with a standard interface for interacting with JSON-RPC services. By encapsulating the OpenRPC specification, it simplifies the workflow for method discovery and invocation. For more details and source code, visit the plugin directory or the GitHub repository.