Plugin System插件系统

Overview概述

Rikune's plugin system allows modular registration of MCP tools. Each plugin exports a register() function that receives the server context and registers tools, hooks, and lifecycle callbacks. Rikune 的插件系统允许模块化注册 MCP 工具。每个插件导出一个 register() 函数，接收服务器上下文并注册工具、钩子和生命周期回调。

Built-in Plugins内置插件

Bundled Plugins随附插件

These 56 plugins ship with the repository under src/plugins/. They are auto-discovered at startup; the final MCP tool surface depends on enabled plugins, progressive discovery, and runtime readiness. The authoritative inventory is maintained in docs/PLUGINS.md. 这 56 个插件随仓库一起发布在 src/plugins/ 下。它们在启动时自动发现；最终 MCP 工具面取决于启用插件、渐进式发现和 runtime readiness。权威清单维护在 docs/PLUGINS.md。

Plugin SDK

A plugin is a module that exports a register() function: 插件是一个导出 register() 函数的模块：

import { PluginContext } from './types';

export function register(ctx: PluginContext) {
  ctx.registerTool({
    name: 'my-plugin.hello',
    description: 'Say hello',
    inputSchema: {
      type: 'object',
      properties: {
        name: { type: 'string' }
      }
    },
    async handler({ name }) {
      return { greeting: `Hello, ${name}!` };
    }
  });
}

export const meta = {
  name: 'my-plugin',
  version: '1.0.0',
  description: 'A custom plugin'
};

Plugin Context API插件上下文 API

Configuration配置

Control which plugins are loaded via the PLUGINS environment variable: 通过 PLUGINS 环境变量控制加载哪些插件：

# Load all plugins (default)
PLUGINS=*

# Load only specific plugins
PLUGINS=pe-analysis,ghidra,detection

# Exclude specific plugins
PLUGINS=*,-docker-backend

Introspection Tools内省工具

Use these MCP tools to inspect the plugin system at runtime: 使用以下 MCP 工具在运行时检查插件系统：

Plugin Lifecycle插件生命周期

1. Discovery发现 — Server scans the src/plugins/ directory for modules with register() exports. 服务器扫描 src/plugins/ 目录，查找导出 register() 的模块。
2. Check检查 — Each plugin's check() verifies dependencies are met (e.g., Ghidra installed). 每个插件的 check() 验证依赖是否满足（如 Ghidra 已安装）。
3. Register注册 — register() is called, tools are added to the registry. 调用 register()，工具被添加到注册表。
4. Ready就绪 — Plugin is active and tools are available to MCP clients. 插件已激活，工具可供 MCP 客户端使用。
5. Teardown清理 — teardown() is called on server shutdown for cleanup. 服务器关闭时调用 teardown() 进行清理。

Lifecycle Hooks生命周期钩子

Plugins can register hooks to intercept tool execution:插件可以注册钩子拦截工具执行：

Three Ways to Write Plugins三种编写插件的方式