语义工具匹配服务器

gem 'legion-mcp'

gem 'legion-mcp', '~> 0.9'

Legion::MCP
├── Server              # MCP::Server builder, governance-aware build; tool list sourced via DeferredRegistry
├── Auth                # JWT + API key authentication
├── Utils               # Pure-function summarization and formatting helpers
├── ToolGovernance      # Risk-tier tool filtering + invocation audit
├── ToolAdapter         # Adapts Legion::Tools::Base to MCP SDK format; handles :mcp_remote dispatch
├── DeferredRegistry    # Reads deferred/always-loaded tools from Settings::Extensions at request time
├── ContextCompiler     # Keyword + semantic tool matching (60/40 blend), 17 categories
├── EmbeddingIndex      # In-memory vector cache for semantic matching
├── Observer            # Instrumentation: counters, ring buffer, intent tracking, pattern promotion
├── UsageFilter         # Frequency/recency/keyword scoring for dynamic tool filtering
├── DynamicInjector     # Context-aware tool injection/removal with tools/list_changed notification
├── CatalogDispatcher   # Dispatch layer routing MCP calls through Legion::Ingress
├── Patterns::Store     # 3-layer degrading storage (L0 memory -> L1 cache -> L2 SQLite)
├── Patterns::Schema    # Portable pattern format with trust-level confidence capping
├── Patterns::Exchange  # Bulk import/export of patterns via JSON files
├── Patterns::Gossip    # AMQP-based pattern sharing between instances
├── Patterns::Compiler  # Compressed tool definitions and compiled workflows
├── TierRouter          # Confidence-gated tier selection (0/1/2)
├── ContextGuard        # Staleness, rapid-fire, anomaly detection guards
├── StateTracker        # In-memory state snapshots with delta diff computation
├── StructuralIndex     # Precomputed index of extensions, runners, actors, and tools
├── ToolQuality         # Docstring quality audit, category resolution, capability matrix
├── GapDetector         # Unmatched intents, high-failure tools, stale candidate detection
├── SelfGenerate        # Gap detection + publication cycles with cooldown
├── OverrideBroadcast   # Mesh-wide override confirmation via RabbitMQ
├── TracingContext       # Thread-local conversation/request/exchange/trace ID propagation
├── Client::Pool        # Remote MCP server connections; registers tools into Settings::Extensions
├── Client::Connection  # stdio and HTTP transport connections with TTL-cached tool lists
├── Client::ServerRegistry # Static and dynamic server registration with health tracking
├── Tools/              # 10 MCP-specific + 18 legion-data CRUD tools; extension tools via Settings::Extensions
└── Resources/          # RunnerCatalog, ExtensionInfo

# Via settings (loaded at boot)
# settings/mcp.json:
# { "mcp": { "servers": { "code_server": { "transport": "stdio", "command": "npx @example/mcp-server" } } } }

Legion::MCP::Client.boot

# Or register at runtime
Legion::MCP::Client.register(:my_server, transport: :http, url: 'http://localhost:9393/mcp')

# All remote tools are registered into Settings::Extensions with dispatch_type: :mcp_remote
tools = Legion::MCP::Client::Pool.all_tools

require 'legion/mcp'

server = Legion::MCP.server
server.start

# stdio transport (default)
legionio mcp stdio

# HTTP transport
legionio mcp http --port 9393

result = Legion::MCP::TierRouter.route(
  intent: "list all running tasks",
  params: { status: "running" },
  context: {}
)

case result[:tier]
when 0 then puts "Cached: #{result[:response]}"
when 1 then puts "Escalate to local model"
when 2 then puts "Escalate to cloud LLM"
end

server = Legion::MCP.server_for(token: jwt_token)
# Returns governance-filtered tool set based on JWT claims

{
  "mcp": {
    "auth": {
      "enabled": false,
      "require_auth": false,
      "jwt_secret": null,
      "jwt_algorithm": "HS256",
      "jwt_issuer": "legion",
      "allowed_api_keys": []
    },
    "governance": {
      "enabled": false,
      "audit_invocations": true,
      "tool_risk_tiers": {}
    },
    "deferred_loading": {
      "enabled": true,
      "always_loaded": []
    },
    "dynamic_tools": {
      "enabled": false,
      "max_injected": 10
    },
    "tier0": {
      "guards": {
        "max_stale_seconds": 3600,
        "rapid_fire_threshold": 5,
        "rapid_fire_window_seconds": 600
      }
    },
    "auto_expose_runners": false,
    "servers": {},
    "cold_start": {
      "patterns_path": null
    },
    "roles": {}
  }
}

bundle install
bundle exec rspec       # 0 failures
bundle exec rubocop -A  # auto-fix
bundle exec rubocop     # lint check