legion-mcp 0.5.7 → 0.5.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5fb13bd52360660f5ec746ccd39b61938e88f6162d6fec55e7e6d059b8e587ef
-  data.tar.gz: 54686c0f6a9e748903766e4492b83fed3bd1780295795fd17bcd14142f3a1703
+  metadata.gz: 0ff0343837c41b8a3c90e88f6d307244d57d0b37ca8c48cc9c4b8b346aefeb51
+  data.tar.gz: 6e222e352d5f1484a4f40e8893c8c2c9b71315052d3bfbda72a48c6f4f2369a4
 SHA512:
-  metadata.gz: 4a2830fb09b04b792a8b15e118e39b71135db74cc1e9a8e701940283b12bad28b406003005b3a39effda3c213b6b73e360dc767c91152a0c466f50196ec7b99e
-  data.tar.gz: adfb0ea1edb2f5851e9ca7855687a976f33d6959ed891ca95e0666dd738fd74934234132d26a2c72315a39308150f845544caba3a306d4bebb05bbbc1e0971c2
+  metadata.gz: 3fa4b7fab3a42f425bd63d91bc2a97802a12ecb5374313b85d21f959e4b8f63fff13ef8daf7d0c95f3de698bb07ad4cf3aacedbcddfbe391383a54d31a4b422b
+  data.tar.gz: 3d74c974da483a0384ebaee0fb2420541e2aa9f00de38e562be09ecef2673ab284080821e030616268e9b5947345e82bce8d29da7a7fc1d8dd3114f32c584299

data/.rubocop.yml

@@ -10,6 +10,7 @@ AllCops:
 Metrics/BlockLength:
   Exclude:
     - 'spec/**/*'
+    - '*.gemspec'
 
 Naming/PredicateMethod:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # legion-mcp Changelog
 
+## [0.5.8] - 2026-03-26
+
+### Added
+- `legion.query_knowledge` MCP tool: search document knowledge base with optional LLM synthesis (closes #3)
+  - Inputs: question (required), top_k (default 5), synthesize (default true)
+  - Guards with defined?() — returns error response if lex-knowledge not loaded
+  - Tool count: 56 → 57
+
 ## [0.5.7] - 2026-03-25
 
 ### Changed

data/legion-mcp.gemspec

@@ -27,9 +27,9 @@ Gem::Specification.new do |spec|
   }
 
   spec.add_dependency 'concurrent-ruby', '>= 1.2'
-  spec.add_dependency 'mcp', '~> 0.8'
   spec.add_dependency 'legion-data', '>= 1.4.19'
   spec.add_dependency 'legion-json', '>= 1.2.0'
   spec.add_dependency 'legion-logging', '>= 1.2.8'
   spec.add_dependency 'legion-settings', '>= 1.3.12'
+  spec.add_dependency 'mcp', '~> 0.8'
 end

data/lib/legion/mcp/server.rb

@@ -64,6 +64,7 @@ require_relative 'tools/mind_growth_approve'
 require_relative 'tools/mind_growth_build_queue'
 require_relative 'tools/mind_growth_cognitive_profile'
 require_relative 'tools/mind_growth_health'
+require_relative 'tools/query_knowledge'
 require_relative 'catalog_bridge'
 require_relative 'resources/runner_catalog'
 require_relative 'resources/extension_info'
@@ -127,7 +128,8 @@ module Legion
         Tools::MindGrowthApprove,
         Tools::MindGrowthBuildQueue,
         Tools::MindGrowthCognitiveProfile,
-        Tools::MindGrowthHealth
+        Tools::MindGrowthHealth,
+        Tools::QueryKnowledge
       ].freeze
 
       class << self

data/lib/legion/mcp/tools/query_knowledge.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class QueryKnowledge < ::MCP::Tool
+        tool_name 'legion.query_knowledge'
+        description 'Search the document knowledge base. Returns a synthesized answer and ranked source chunks.'
+
+        input_schema(
+          properties: {
+            question:   { type: 'string',  description: 'The question or search query' },
+            top_k:      { type: 'integer', description: 'Number of source chunks to retrieve (default 5)' },
+            synthesize: { type: 'boolean', description: 'Whether to synthesize an LLM answer (default true)' }
+          },
+          required:   %w[question]
+        )
+
+        class << self
+          def call(question:, top_k: 5, synthesize: true)
+            return error_response('lex-knowledge is not available') unless knowledge_available?
+
+            result = Legion::Extensions::Knowledge::Runners::Query.query(
+              question:   question,
+              top_k:      top_k,
+              synthesize: synthesize
+            )
+            text_response(result)
+          rescue StandardError => e
+            Legion::Logging.warn("QueryKnowledge#call failed: #{e.message}") if defined?(Legion::Logging)
+            error_response("Knowledge query failed: #{e.message}")
+          end
+
+          private
+
+          def knowledge_available?
+            defined?(Legion::Extensions::Knowledge::Runners::Query)
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            body = { error: msg }
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(body) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module MCP
-    VERSION = '0.5.7'
+    VERSION = '0.5.8'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.5.8
 platform: ruby
 authors:
 - Esity
@@ -23,20 +23,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: mcp
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: legion-data
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +79,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.12
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
 description: Model Context Protocol server with semantic tool matching, observation
   pipeline, and tiered inference for LegionIO
 email:
@@ -190,6 +190,7 @@ files:
 - lib/legion/mcp/tools/prompt_list.rb
 - lib/legion/mcp/tools/prompt_run.rb
 - lib/legion/mcp/tools/prompt_show.rb
+- lib/legion/mcp/tools/query_knowledge.rb
 - lib/legion/mcp/tools/rbac_assignments.rb
 - lib/legion/mcp/tools/rbac_check.rb
 - lib/legion/mcp/tools/rbac_grants.rb