Preface

In DSH Web plugins, MCP servers and the Skill catalog affect the set of tools visible to the model and also consume context. lilyblessing/dsh-mcp-skill-panel places both types of objects into a settings panel for viewing, enabling/disabling, and on-demand restoration. It also provides an optional AI middle layer that allows disabled MCPs to be used on demand by the model via mcp_search / mcp_call.

What This Is

This is a DSH Web plugin. The repository owner is lilyblessing, the package version is 0.5.3, the npm latest version is 0.5.3, and the license is MIT. It addresses the issues where MCP and Skill toggling is not intuitive and context usage is difficult to release temporarily.

Core Features

MCP Management

  • Real-time MCP enable/disable.
  • Tool-level disabling.
  • Disabled-state backfill.
  • Paste mcpServers JSON for quick migration and addition.
  • Project-level MCP: reads workspace .dsh/mcps/**/mcp.json, visible only to sessions in that project workspace.
  • Enable/disable intent persists across restarts. The persistence path is ~/.dsh/dsh-mcp-skill-panel/state.json, with a catalog snapshot used for backfill after restart.

Skill Management

  • Skill enable/disable.
  • Create skills: fill in name, description, and instructions; optionally upload SKILL.md for pre-filling.
  • Manual management: edit disable-model-invocation in the SKILL.md frontmatter.

AI Middle Layer

  • Optional toggle named autoManage.
  • When enabled, disabled MCPs can be invoked on demand by the model via mcp_search / mcp_call.
  • MCPs manually enabled by the user are never automatically disabled; the reclaimer only reclaims servers that the AI temporarily enabled from a disabled state.

Effective Timing

  • Manual toggles can take effect immediately or in the next session.
  • Immediate effect invalidates 100% of the prefix KV-Cache for the next round. That round is billed at the miss rate, approximately 5 to 12.5 times the hit rate.
  • Taking effect in the next session incurs zero cache invalidation and zero additional cost.
  • If necessary, you can click the “Apply pending changes now” button to force changes into effect.

Installation and Enablement

The following command installs the plugin from the git source:

dsh plugin --profile web add "github:lilyblessing/dsh-mcp-skill-panel#main"

After installation, restart dsh web; hot reload does not work. After restarting, go to the settings page to use the MCP and Skill management panel.

If installing or upgrading from the npm package name dsh-mcp-skill-panel:

pnpm add dsh-mcp-skill-panel@latest

If upgrading a git-source installation:

pnpm update dsh-mcp-skill-panel

Typical Usage

  1. On the settings page, enter the MCP and Skill management panel.

  2. In the MCP servers tab, enable or disable servers, or expand the tool list to disable tools individually.

  3. In the Skills tab, enable or disable skills, or fill in name, description, and instructions when creating a skill, optionally uploading SKILL.md for pre-filling.

  4. After enabling the AI middle layer toggle, disabled MCPs can be invoked on demand by the model via mcp_search / mcp_call.

  5. For manual toggles, choose immediate effectiveness or next-session effectiveness; if necessary, click “Apply pending changes now”.

  6. Add MCPs on the MCP page: paste the mcpServers JSON from another harness, preview it, then choose global or project-level addition.

  7. Manual management: directly edit the disabled line in the preset combination file, or edit the disable-model-invocation field in the SKILL.md frontmatter.

Authentication and Panel Behavior

For write operations, authentication has required a token header in POST requests since version 0.4.7:

x-panel-token: <token>

A 401 is returned if the token is missing. GET read-only endpoints remain open.

The panel uses optimistic updates and event-driven invalidation. The UI supports bilingual display, and the plugin itself consumes zero context.

Applicable Scenarios and Notes

Suitable for developers who need to centrally manage MCP servers and Skills in DSH Web plugins, control context usage, and enable tools on demand.

This plugin runs with the permissions of the current dsh process. Before installation, review the source code and the MIT license. When using manual toggles, you need to understand the KV-Cache cost difference between immediate effectiveness and next-session effectiveness.

Acquisition

GitHub repository:

https://github.com/lilyblessing/dsh-mcp-skill-panel