Preface

When developing agents using DeepSeek Harness (DSH), troubleshooting Kubernetes-related issues often requires manually consulting external documentation. The xby-kubernetes-runbooks plugin introduces a server based on the Model Context Protocol (MCP), directly providing access to Kubernetes troubleshooting runbooks within the conversation, and supporting search, content retrieval, and AI integration.

Plugin Introduction

This plugin is an MCP server maintained by xby-skill. It addresses the core problem of enabling agents to retrieve Kubernetes troubleshooting runbooks, thereby assisting automated fault diagnosis or generating troubleshooting recommendations.

Core Features

The plugin provides the following four core capabilities:
* set_xby_apikey: Sets an API key in the chat context. This key is automatically persisted and remains valid after a restart.
* fetch_runbook: Retrieves a specific Kubernetes troubleshooting runbook based on the specified topic.
* search_runbooks: Searches Kubernetes troubleshooting runbooks by keyword.
* list_topics: Lists all available Kubernetes troubleshooting runbook topics.

Installation and Enablement

Install it using the command provided by the official documentation. After installation, the plugin runs as an MCP server in the DSH environment.

dsh plugin --profile web add github:xby_skill/xby-kubernetes-runbooks

Configuration and Usage

Before using the plugin, you need to configure an API key. To obtain a key, you must register on the Xiaobenyang official website.

  1. Set the API Key
    In the chat, invoke the set_xby_apikey command and pass in the obtained key. The key is automatically saved by the system.

  2. View Available Topics
    Invoke list_topics to list all currently available troubleshooting runbook topics, making it easier to understand which resources are available for retrieval.

  3. Search Runbooks
    When encountering a specific Kubernetes error, invoke search_runbooks and enter a keyword. The plugin returns the contents of related troubleshooting runbooks.

  4. Retrieve a Specific Runbook
    If the search results point to a specific topic, invoke fetch_runbook and pass the topic name to retrieve the complete troubleshooting steps.

Use Cases and Cautions

  • Use Cases: Suitable for DSH users who need to perform troubleshooting or automated operations based on Kubernetes runtime knowledge.
  • Cautions: This plugin runs with the permissions of the current DSH process. It is recommended to inspect the source code before installation to ensure security. The plugin is released under the MIT license. Additionally, obtaining an API key requires registration on a third-party website (the Xiaobenyang official website), and the plugin’s homepage and author information are currently empty.

Conclusion

By integrating Kubernetes troubleshooting runbooks, this plugin lowers the barrier for agents to acquire professional operations and maintenance knowledge. To view more details, please visit the plugin catalog or the GitHub repository.