swagger_mcp_tool 0.1.1

data/lib/swagger_mcp_tool/tool_registry.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+require 'mcp'
+require 'json'
+require 'net/http'
+require_relative 'api_client'
+require_relative 'logging'
+require_relative 'config'
+
+module SwaggerMCPTool
+  # Registry for managing dynamic MCP tools
+  class ToolRegistry
+    include Singleton
+
+    attr_accessor :dynamic_tools
+
+    def initialize(config = nil, logger = nil)
+      @dynamic_tools = []
+      @tool_names = Set.new
+      @logger = logger || config&.logger || Logger.new($stdout)
+    end
+
+    def register_dynamic_tools(tools, base_url, _swagger_spec = nil)
+      ensure_setup!
+      @dynamic_tools = @config.tools if @config&.tools
+      validate_inputs!(tools, base_url)
+      @logger.info "Registering #{tools.size} dynamic tools"
+
+      tools.each do |tool_def|
+        register_tool(tool_def, base_url) unless tool_exists?(tool_def['name'])
+      end
+
+      @logger.info "Successfully registered #{@dynamic_tools.size} tools"
+      @dynamic_tools.size
+    end
+
+    def setup(config = nil, logger = nil)
+      return if @initialized
+
+      @config = config
+      @logger = logger || config&.logger || Logger.new($stdout)
+      @initialized = true
+      @tool_names = Set.new
+      @dynamic_tools = []
+
+      @logger.info 'ToolRegistry singleton initialized'
+    end
+
+    # Guard method to ensure setup is called
+    def ensure_setup!
+      return if @initialized
+
+      raise 'ToolRegistry must be setup before use. Call ToolRegistry.instance.setup(config, logger)'
+    end
+
+    def execute_tool(context, args, server_context)
+      execute_tool_with_context(context, args, server_context)
+    end
+
+    def create_mcp_tool(tool_def, base_url)
+      schema = build_clean_schema(tool_def['parameters'])
+
+      execution_context = create_execution_context(tool_def, base_url)
+      registry_instance = self
+
+      MCP::Tool.define(
+        name: tool_def['name'],
+        description: tool_def['description'],
+        input_schema: schema,
+        annotations: build_annotations(tool_def['name'], tool_def['method'])
+      ) do |args = {}, server_context = {}|
+        registry_instance.execute_tool(execution_context, args, server_context)
+      end
+    end
+
+    private
+
+    def prepare_execution_state(context, args, server_context)
+      {
+        tool_name: context[:tool_name],
+        method: context[:method],
+        path: context[:path],
+        base_url: context[:base_url],
+        logger: context[:logger],
+        args: args,
+        server_context: extract_server_context(args, server_context)
+      }
+    end
+
+    def tool_exists?(tool_name)
+      @tool_names.include?(tool_name)
+    end
+
+    def validate_inputs!(tools, base_url)
+      raise ArgumentError, 'Tools must be an array' unless tools.is_a?(Array)
+      raise ArgumentError, 'Base URL cannot be empty' if base_url.nil? || base_url.strip.empty?
+    end
+
+    def register_tool(tool_def, base_url)
+      tool_name = tool_def['name']
+      mcp_tool = create_mcp_tool(tool_def, base_url)
+      @dynamic_tools << mcp_tool
+      @tool_names.add(tool_name)
+
+      @logger.info "Registered tool: #{tool_name}"
+    rescue StandardError => e
+      @logger.error "Failed to register #{tool_name}: #{e.message}"
+    end
+
+    def create_execution_context(tool_def, base_url)
+      {
+        tool_name: tool_def['name'],
+        method: tool_def['method'],
+        path: tool_def['path'],
+        base_url: base_url,
+        logger: @logger,
+        config: @config
+      }
+    end
+
+    def build_clean_schema(parameters)
+      return { type: 'object', properties: {}, required: [] } unless parameters
+
+      properties = clean_properties(parameters['properties'] || {})
+      required = filter_required_fields(parameters['required'] || [], properties)
+
+      {
+        type: 'object',
+        properties: properties,
+        required: required
+      }
+    end
+
+    def clean_properties(original_properties)
+      original_properties.each_with_object({}) do |(prop_name, prop_def), clean_props|
+        if valid_property?(prop_def)
+          clean_props[prop_name] = prop_def
+        else
+          @logger.warn "Invalid property #{prop_name}, skipping"
+        end
+      end
+    end
+
+    def valid_property?(prop_def)
+      prop_def.is_a?(Hash) && prop_def['type']
+    end
+
+    def filter_required_fields(required_fields, properties)
+      required_fields.select { |field| properties.key?(field) }
+    end
+
+    def build_annotations(tool_name, tool_method)
+      method_lower = tool_method.downcase
+
+      {
+        title: tool_name,
+        read_only_hint: method_lower == 'get',
+        destructive_hint: destructive_method?(method_lower),
+        idempotent_hint: idempotent_method?(method_lower),
+        open_world_hint: false
+      }
+    end
+
+    def destructive_method?(method)
+      %w[delete put patch].include?(method)
+    end
+
+    def idempotent_method?(method)
+      %w[get put delete].include?(method)
+    end
+
+    def execute_tool_with_context(context, args, server_context)
+      execution_state = prepare_execution_state(context, args, server_context)
+      log_execution_start(execution_state)
+
+      response = make_api_request(execution_state)
+
+      log_execution_success(execution_state)
+      response
+    rescue StandardError => e
+      log_tool_execution_error(execution_state, e)
+      create_error_response(e.message)
+    end
+
+    def make_api_request(state)
+      @logger.debug "Making API request with state: #{state.inspect}"
+      api_client = SwaggerMCPTool::ApiClient.new(state[:base_url])
+      api_client.make_request(state[:method], state[:path], state[:args], state[:server_context])
+    end
+
+    def extract_server_context(args, server_context)
+      server_context.empty? ? args.delete(:server_context) || {} : server_context
+    end
+
+    def log_execution_success(state)
+      state[:logger].info "=== TOOL SUCCESS: #{state[:tool_name]} ==="
+    end
+
+    def log_execution_start(context)
+      context[:logger].info "=== EXECUTING TOOL: #{context[:tool_name]} ==="
+      context[:logger].info "Method: #{context[:method].upcase}, Path: #{context[:path]}"
+      context[:logger].info "Params: #{context[:args].inspect}"
+    end
+
+    def log_tool_execution_error(state, error)
+      state[:logger].error "=== TOOL ERROR: #{state[:tool_name]} ==="
+      state[:logger].error "Error: #{error.message}"
+      state[:logger].debug "Backtrace: #{error.backtrace.join("\n")}"
+    end
+  end
+end

data/lib/swagger_mcp_tool/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SwaggerMcpTool
+  VERSION = '0.1.1'
+end

data/lib/swagger_mcp_tool.rb

@@ -0,0 +1,21 @@
+require 'swagger_mcp_tool/version'
+require 'swagger_mcp_tool/config'
+require 'swagger_mcp_tool/server'
+require 'swagger_mcp_tool/swagger_client'
+require 'swagger_mcp_tool/tool_generator'
+require 'swagger_mcp_tool/api_client'
+require 'swagger_mcp_tool/auth_handler'
+
+module SwaggerMCPTool
+  class Error < StandardError; end
+
+  # Start the server with the current configuration
+  def self.start_server
+    Server.start
+  end
+
+  # Configure the server
+  def self.configure(&block)
+    Config.configure(&block)
+  end
+end

metadata

@@ -0,0 +1,221 @@
+--- !ruby/object:Gem::Specification
+name: swagger_mcp_tool
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Ankit
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-08-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.12.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.12.2
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.6'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+- !ruby/object:Gem::Dependency
+  name: sinatra-contrib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.1.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.9
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.13.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.13.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: A Model Context Protocol (MCP) server that generates tools from Swagger/OpenAPI
+  specifications
+email:
+- akisingh501@gmail.com
+executables:
+- swagger_mcp_server
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/console
+- bin/setup
+- bin/swagger_mcp_server
+- lib/swagger_mcp_tool.rb
+- lib/swagger_mcp_tool/api_client.rb
+- lib/swagger_mcp_tool/auth_handler.rb
+- lib/swagger_mcp_tool/config.rb
+- lib/swagger_mcp_tool/helpers/parameter_processor.rb
+- lib/swagger_mcp_tool/helpers/request.rb
+- lib/swagger_mcp_tool/helpers/request_body_processor.rb
+- lib/swagger_mcp_tool/helpers/swagger_validator.rb
+- lib/swagger_mcp_tool/helpers/tool_builder.rb
+- lib/swagger_mcp_tool/helpers/tool_register.rb
+- lib/swagger_mcp_tool/logging.rb
+- lib/swagger_mcp_tool/server.rb
+- lib/swagger_mcp_tool/swagger_client.rb
+- lib/swagger_mcp_tool/tool_generator.rb
+- lib/swagger_mcp_tool/tool_registry.rb
+- lib/swagger_mcp_tool/version.rb
+homepage: https://github.com/yourusername/swagger_mcp_tool
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: MCP server for Swagger/OpenAPI specifications
+test_files: []