MCP and Skills

MCP and Skills

LingXiao uses the MCP protocol and Skills system to make Agent capabilities extensible, shareable, and injectable.

MCP Share

MCP Share provides share code export/import for cross-environment MCP Server sharing:

• Export: Generate share codes, package server files + config + metadata as a bundle
• Import: Import MCP Server via share code, with automatic validation and registration
• Preview: Preview bundle contents before importing

Share Code Structure

interface McpBundle {
  serverFiles: Record<string, string>;  // Source files
  config: McpServerConfig;              // MCP configuration
  metadata: {
    name: string;
    description: string;
    version: string;
    createdAt: string;
  };
}

Skills System

Skills are execution knowledge, processes, and domain constraints injected into Agent context.

4-Layer Source Priority

Project-level›Plugin-contributed›User-level›Built-in

Source	Path	Description
Project-level	.lingxiao/skills/	Project-specific skills, highest priority
Plugin-contributed	Plugin skills/ directory	Skills installed via plugin marketplace
User-level	~/.lingxiao/skills/	Global user skills, cross-project
Built-in	Bundled with LingXiao	Built-in skill packages

Skill Structure

Each Skill consists of YAML frontmatter and Markdown body:

---
name: security-review
description: Security review skill
phases:
  - analyze
  - review
  - report
priority: high
---

# Security Review Process

## Analysis Phase
Check dependency vulnerabilities, input validation, permission boundaries...

## Review Phase
Review security risks file by file...

## Report Phase
Generate security review report...

Phase Loading

Skills support per-phase file loading:

skills/

security-review/Skills security review directory

index.mdSkill main file (frontmatter)

phases/Phase directory

analyze.mdAnalysis phase knowledge

review.mdReview phase knowledge

report.mdReport phase knowledge

Each phase file passes Quality Gate validation before being injected into Worker prompts.

Skill Binding

The Leader binds skills via skill_names in define_agent_role or create_task:

{
  name: "security-auditor",
  skillNames: ["security-review", "owasp-top10"],
  // Skill content is auto-injected at Worker dispatch time
}

Unified MCP Entry Point

All MCP Servers are accessed through the unified mcp tool:

mcp(action="list_servers")       # List installed MCP Servers
mcp(action="list_tools")         # Discover MCP Tools
mcp(action="call_tool", ...)     # Call MCP Tool
mcp(action="list_resources")     # Discover MCP Resources
mcp(action="read_resource", ...) # Read MCP Resource
mcp(action="list_prompts")       # Discover MCP Prompts
mcp(action="get_prompt", ...)    # Get MCP Prompt

Plugin-contributed MCP Servers are synced to settings.mcp.servers, managed alongside manually installed Servers.