rubygems_mcp 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afa4ece822d5b8556b280d14c3755876420957ba7e6b080cb20aa529730bb93e
-  data.tar.gz: 5e96e90380d30f47fe2e2f765cf4e5831093bfefde80757a60aede6cf46f5753
+  metadata.gz: 1a2188f3290de5f410a66437e48bacda1dfd194b7c8446ce6f7db4b6dbb5d644
+  data.tar.gz: 1d6604125b76ed9493535466306d64d0f948b921d437b86faaa95016df2314b5
 SHA512:
-  metadata.gz: 9f07be5cde29b994821781e0350711b02df4a4f22e93ace9b860dfa6e23d81354639c6d6078da12768ba50a32d95ea89a64224c355ae39efe5486acf9af432eb
-  data.tar.gz: e648da457c4b257a2dabcf41e9b682825cb4d588012e8eefd0bd46c8b399578bb7ae9a50e87345228538efb2d7c5449904b4fc75f3206a28a229b1ebf9a80bbf
+  metadata.gz: be31aff229ddfd131b59e52fe42db7af5d9787e0833bf066baa90c7155f0973e5e2f17e7dd42e443650098464212b9c832671e5b7e01b22e3f9aa185eb13682f
+  data.tar.gz: 38237f1b2c2f1ead4ebf0e72c0587bd005eec054a153db2081c5211ab86f7e00b0b4ad2d0b4c349d4828850a457b748b9f2a4fee5cb2507522f11368cb62ab02

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # CHANGELOG
 
+## 0.1.1 (2025-11-21)
+
+- Update fast-mcp dependency version constraints to allow versions >= 0.1 and < 2.0
+- Fix Resource class references to use FastMcp::Resource instead of MCP::Resource
+- Update resource methods from `default_content` to `content` to match fast-mcp 1.0.0+ API
+- Fix test expectations to match fast-mcp API (tool names without `::` separators, resources as Array)
+- Add explicit `tool_name` definitions to all tools for user-friendly snake_case names (e.g., `get_latest_versions` instead of long class names)
+- Fix array argument definitions: Change from `filled(:array)` to `array(:string)` to fix JSON schema conversion errors with dry-schema 1.14.1+ (fixes "Could not find an equivalent conversion for type :array" error)
+
 ## 0.1.0 (2025-01-15)
 
 - Initial release

data/lib/rubygems_mcp/client.rb

@@ -349,18 +349,18 @@ module RubygemsMcp
       end
     end
 
-    # Get changelog summary for a Ruby version from release notes
+    # Get full changelog content for a Ruby version from release notes
     #
     # @param version [String] Ruby version (e.g., "3.4.7")
-    # @return [Hash] Hash with :version, :release_notes_url, and :summary
+    # @return [Hash] Hash with :version, :release_notes_url, and :content (full content)
     def get_ruby_version_changelog(version)
       # First get the release notes URL for this version
       versions = get_ruby_versions
       version_data = versions.find { |v| v[:version] == version }
-      return {version: version, release_notes_url: nil, summary: nil, error: "Version not found"} unless version_data
+      return {version: version, release_notes_url: nil, content: nil, error: "Version not found"} unless version_data
 
       release_notes_url = version_data[:release_notes_url]
-      return {version: version, release_notes_url: nil, summary: nil, error: "No release notes available"} unless release_notes_url
+      return {version: version, release_notes_url: nil, content: nil, error: "No release notes available"} unless release_notes_url
 
       cache_key = "ruby_changelog:#{version}"
 
@@ -371,29 +371,32 @@ module RubygemsMcp
 
       uri = URI(release_notes_url)
       response = make_request(uri, parse_html: true)
-      return {version: version, release_notes_url: release_notes_url, summary: nil, error: "Failed to fetch release notes"} unless response
+      return {version: version, release_notes_url: release_notes_url, content: nil, error: "Failed to fetch release notes"} unless response
 
-      # Extract the main content - typically in a div with class "content" or "entry-content"
-      # Try multiple selectors to find the main content
-      content = response.css("div.content, div.entry-content, article, main").first || response.css("body").first
+      # Extract the main content - Ruby release notes use div#content
+      content = response.css("div#content").first || response.css("div.content, div.entry-content, article, main").first
 
       if content
-        # Extract text, remove excessive whitespace, and get first few paragraphs
+        # Remove navigation and metadata elements
+        content.css("p.post-info, .post-info, nav, .navigation, header, footer, .sidebar").remove
+
+        # Get the full text content, preserving structure
         text = content.text.strip
-        # Split into paragraphs and take first 3-5 meaningful ones
-        paragraphs = text.split(/\n\n+/).reject { |p| p.strip.length < 50 }
-        summary = paragraphs.first(5).join("\n\n").strip
 
-        # Limit summary length
-        summary = summary[0..2000] + "..." if summary.length > 2000
+        # Clean up excessive whitespace but preserve paragraph structure
+        text = text.gsub(/\n{3,}/, "\n\n")
+        text = text.gsub(/[ \t]+/, " ")
+
+        # Remove empty lines at start/end
+        text = text.strip
       else
-        summary = nil
+        text = nil
       end
 
       result = {
         version: version,
         release_notes_url: release_notes_url,
-        summary: summary
+        content: text
       }
 
       # Cache for 24 hours
@@ -562,9 +565,10 @@ module RubygemsMcp
 
       # Extract the main content - try GitHub release page first, then generic selectors
       content = if changelog_uri.include?("github.com") && changelog_uri.include?("/releases/")
-        # GitHub release page - look for release notes in markdown-body or release notes section
-        response.css(".markdown-body, .release-body, [data-testid='release-body']").first ||
-          response.css("div.repository-content, article").first
+        # GitHub release page - look for release notes in markdown-body
+        response.css(".markdown-body").first ||
+          response.css("[data-testid='release-body'], .release-body").first ||
+          response.css("div.repository-content article").first
       else
         # Generic changelog page
         response.css("div.content, div.entry-content, article, main, .markdown-body").first
@@ -573,29 +577,90 @@ module RubygemsMcp
       content ||= response.css("body").first
 
       summary = if content
+        # Remove UI elements, navigation, and error messages
+        content.css("nav, header, footer, .navigation, .sidebar, .blankslate, details, summary, .Box-footer, .Counter, [data-view-component], script, style").remove
+
+        # Remove elements with common UI classes
+        content.css("[class*='blankslate'], [class*='Box-footer'], [class*='Counter'], [class*='details-toggle']").remove
+
+        # Get text content
         text = content.text.strip
-        # Remove common navigation/header text patterns
+
+        # Remove common GitHub UI text patterns
         text = text.gsub(/Notifications.*?signed in.*?reload/im, "")
         text = text.gsub(/You must be signed in.*?reload/im, "")
         text = text.gsub(/There was an error.*?reload/im, "")
+        text = text.gsub(/Please reload this page.*?/im, "")
+        text = text.gsub(/Loading.*?/im, "")
+        text = text.gsub(/Uh oh!.*?/im, "")
+        text = text.gsub(/Assets.*?\d+.*?/im, "")
+
+        # Remove commit hashes and issue references that are just links without context
+        text = text.gsub(/\b[a-f0-9]{7,40}\b/, "") # Remove commit hashes
+        text = text.gsub(/#\d+\s*$/, "") # Remove trailing issue numbers without context
+
+        # Clean up whitespace
+        text = text.gsub(/\n{3,}/, "\n\n")
+        text = text.gsub(/[ \t]{2,}/, " ")
+
+        # Split into lines and filter out irrelevant content
+        lines = text.split(/\n+/)
+
+        # Filter out lines that are likely UI elements or irrelevant
+        filtered_lines = []
+        prev_line_was_meaningful = false
+
+        lines.each_with_index do |line, idx|
+          stripped = line.strip
+          next if stripped.empty?
+
+          # Skip UI elements
+          next if stripped.match?(/^(Notifications|You must|There was|Please reload|Loading|Uh oh|Assets|\d+\s*$)/i)
+          next if stripped.match?(/^\/\s*$/)
+          next if stripped.match?(/^[a-f0-9]{7,40}$/) # Standalone commit hashes
+          next if stripped.match?(/^\s*#\d+\s*$/) # Standalone issue numbers
+
+          # Skip author names that appear alone (pattern: First Last or First Middle Last)
+          # Author names typically appear after a change description ends with punctuation
+          if stripped.match?(/^[A-Z][a-z]+(?:\s+[A-Z][a-z]+){1,2}$/) && stripped.length < 50 && !stripped.match?(/^[A-Z][a-z]+ [A-Z]\./) # Not initials like "J. Smith"
+            # Check if previous line ends with punctuation (end of sentence = author attribution follows)
+            if idx > 0 && filtered_lines.any?
+              prev = filtered_lines.last.to_s.strip
+              # If previous line ends with punctuation, this standalone name is likely an author
+              if prev.match?(/[.!]$/)
+                next
+              end
+            elsif idx == 0
+              # First line that's just a name, skip it
+              next
+            end
+          end
 
-        # Split into paragraphs and take first 5-10 meaningful ones
-        # Try splitting by double newlines first, then by single newlines if that doesn't work
-        paragraphs = if text.include?("\n\n")
-          text.split(/\n\n+/)
-        else
-          text.split(/\n+/)
+          # Keep meaningful lines
+          if stripped.length >= 10
+            filtered_lines << line
+            prev_line_was_meaningful = true
+          end
         end
 
-        paragraphs = paragraphs.reject { |p|
-          p.strip.length < 30 ||
-            p.match?(/^(rails|Notifications|You must|There was)/i) ||
-            p.match?(/^\/\s*$/)
-        }
-        summary_text = paragraphs.first(10).join("\n\n").strip
+        # Remove trailing "No changes." and similar repetitive endings
+        while filtered_lines.last&.strip&.match?(/^(No changes\.?|Guides)$/i)
+          filtered_lines.pop
+        end
+
+        # Join back and clean up
+        summary_text = filtered_lines.join("\n").strip
+
+        # Remove excessive blank lines
+        summary_text = summary_text.gsub(/\n{3,}/, "\n\n")
+
+        # Limit length but keep it reasonable for changelogs
+        if summary_text.length > 10000
+          # Try to cut at a reasonable point (end of a section)
+          cut_point = summary_text[0..10000].rindex(/\n\n/)
+          summary_text = summary_text[0..(cut_point || 10000)].strip + "\n\n..."
+        end
 
-        # Limit summary length
-        summary_text = summary_text[0..3000] + "..." if summary_text.length > 3000
         summary_text.empty? ? nil : summary_text
       end
 

data/lib/rubygems_mcp/server.rb

@@ -16,6 +16,21 @@ FastMcp = MCP unless defined?(FastMcp)
 module MCP
   module Transports
     class StdioTransport
+      if method_defined?(:send_error)
+        alias_method :original_send_error, :send_error
+
+        def send_error(code, message, id = nil)
+          # Use placeholder id if nil to satisfy strict MCP client validation
+          # JSON-RPC 2.0 allows null for notifications, but MCP clients require valid id
+          id = "error_#{SecureRandom.hex(8)}" if id.nil?
+          original_send_error(code, message, id)
+        end
+      end
+    end
+  end
+
+  class Server
+    if method_defined?(:send_error)
       alias_method :original_send_error, :send_error
 
       def send_error(code, message, id = nil)
@@ -26,17 +41,6 @@ module MCP
       end
     end
   end
-
-  class Server
-    alias_method :original_send_error, :send_error
-
-    def send_error(code, message, id = nil)
-      # Use placeholder id if nil to satisfy strict MCP client validation
-      # JSON-RPC 2.0 allows null for notifications, but MCP clients require valid id
-      id = "error_#{SecureRandom.hex(8)}" if id.nil?
-      original_send_error(code, message, id)
-    end
-  end
 end
 
 module RubygemsMcp
@@ -151,11 +155,12 @@ module RubygemsMcp
 
     # Get latest versions for a list of gems with release dates
     class GetLatestVersionsTool < BaseTool
+      tool_name "get_latest_versions"
       description "Get latest versions for a list of gems with release dates and licenses. Supports GraphQL-like field selection."
 
       arguments do
-        required(:gem_names).filled(:array, min_size?: 1).description("Array of gem names (e.g., ['rails', 'nokogiri', 'rack'])")
-        optional(:fields).filled(:array).description("GraphQL-like field selection. Available: name, version, release_date, license, built_at, prerelease, platform, ruby_version, rubygems_version, downloads_count, sha, spec_sha, requirements, metadata")
+        required(:gem_names).array(:string, min_size?: 1).description("Array of gem names (e.g., ['rails', 'nokogiri', 'rack'])")
+        optional(:fields).array(:string).description("GraphQL-like field selection. Available: name, version, release_date, license, built_at, prerelease, platform, ruby_version, rubygems_version, downloads_count, sha, spec_sha, requirements, metadata")
       end
 
       def call(gem_names:, fields: nil)
@@ -165,6 +170,7 @@ module RubygemsMcp
 
     # Get all versions for a single gem
     class GetGemVersionsTool < BaseTool
+      tool_name "get_gem_versions"
       description "Get all versions for a single gem with release dates and licenses, sorted by version descending. Supports GraphQL-like field selection."
 
       arguments do
@@ -172,7 +178,7 @@ module RubygemsMcp
         optional(:limit).filled(:integer).description("Maximum number of versions to return (for pagination)")
         optional(:offset).filled(:integer).description("Number of versions to skip (for pagination)")
         optional(:sort).filled(:string).description("Sort order: version_desc, version_asc, date_desc, or date_asc (default: version_desc)")
-        optional(:fields).filled(:array).description("GraphQL-like field selection. Available: version, release_date, license, built_at, prerelease, platform, ruby_version, rubygems_version, downloads_count, sha, spec_sha, requirements, metadata")
+        optional(:fields).array(:string).description("GraphQL-like field selection. Available: version, release_date, license, built_at, prerelease, platform, ruby_version, rubygems_version, downloads_count, sha, spec_sha, requirements, metadata")
       end
 
       def call(gem_name:, limit: nil, offset: 0, sort: "version_desc", fields: nil)
@@ -189,6 +195,7 @@ module RubygemsMcp
 
     # Get latest Ruby version with release date
     class GetLatestRubyVersionTool < BaseTool
+      tool_name "get_latest_ruby_version"
       description "Get latest Ruby version with release date"
 
       arguments do
@@ -202,6 +209,7 @@ module RubygemsMcp
 
     # Get all Ruby versions with release dates
     class GetRubyVersionsTool < BaseTool
+      tool_name "get_ruby_versions"
       description "Get all Ruby versions with release dates, download URLs, and release notes URLs, sorted by version descending"
 
       arguments do
@@ -224,6 +232,7 @@ module RubygemsMcp
 
     # Get changelog summary for a Ruby version
     class GetRubyVersionChangelogTool < BaseTool
+      tool_name "get_ruby_version_changelog"
       description "Get changelog summary for a specific Ruby version by fetching and parsing the release notes"
 
       arguments do
@@ -237,11 +246,12 @@ module RubygemsMcp
 
     # Get gem information (summary, homepage, etc.)
     class GetGemInfoTool < BaseTool
+      tool_name "get_gem_info"
       description "Get detailed information about a gem (summary, homepage, source code, documentation, licenses, authors, dependencies, downloads). Supports GraphQL-like field selection."
 
       arguments do
         required(:gem_name).filled(:string).description("Gem name (e.g., 'rails')")
-        optional(:fields).filled(:array).description("GraphQL-like field selection. Available: name, version, summary, description, homepage, source_code, documentation, licenses, authors, info, downloads, version_downloads, yanked, dependencies, changelog_uri, funding_uri, platform, sha, spec_sha, metadata")
+        optional(:fields).array(:string).description("GraphQL-like field selection. Available: name, version, summary, description, homepage, source_code, documentation, licenses, authors, info, downloads, version_downloads, yanked, dependencies, changelog_uri, funding_uri, platform, sha, spec_sha, metadata")
       end
 
       def call(gem_name:, fields: nil)
@@ -251,6 +261,7 @@ module RubygemsMcp
 
     # Get reverse dependencies (gems that depend on this gem)
     class GetGemReverseDependenciesTool < BaseTool
+      tool_name "get_gem_reverse_dependencies"
       description "Get reverse dependencies - list of gems that depend on the specified gem"
 
       arguments do
@@ -264,6 +275,7 @@ module RubygemsMcp
 
     # Get download statistics for a gem version
     class GetGemVersionDownloadsTool < BaseTool
+      tool_name "get_gem_version_downloads"
       description "Get download statistics for a specific gem version"
 
       arguments do
@@ -278,6 +290,7 @@ module RubygemsMcp
 
     # Get latest gems (most recently added)
     class GetLatestGemsTool < BaseTool
+      tool_name "get_latest_gems"
       description "Get latest gems - most recently added gems to RubyGems.org"
 
       arguments do
@@ -291,6 +304,7 @@ module RubygemsMcp
 
     # Get recently updated gems
     class GetRecentlyUpdatedGemsTool < BaseTool
+      tool_name "get_recently_updated_gems"
       description "Get recently updated gems - most recently updated gem versions"
 
       arguments do
@@ -304,6 +318,7 @@ module RubygemsMcp
 
     # Get changelog summary for a gem
     class GetGemChangelogTool < BaseTool
+      tool_name "get_gem_changelog"
       description "Get changelog summary for a gem by fetching and parsing the changelog from its changelog_uri"
 
       arguments do
@@ -318,6 +333,7 @@ module RubygemsMcp
 
     # Search for gems by name
     class SearchGemsTool < BaseTool
+      tool_name "search_gems"
       description "Search for gems by name on RubyGems"
 
       arguments do
@@ -330,13 +346,13 @@ module RubygemsMcp
     end
 
     # Resource: Popular Ruby gems list
-    class PopularGemsResource < MCP::Resource
+    class PopularGemsResource < FastMcp::Resource
       uri "rubygems://popular"
       resource_name "Popular Ruby Gems"
       description "A curated list of popular Ruby gems with their latest versions"
       mime_type "application/json"
 
-      def default_content
+      def content
         client = Client.new
         popular_gems = %w[
           rails nokogiri bundler rake rspec devise puma sidekiq
@@ -366,13 +382,13 @@ module RubygemsMcp
     end
 
     # Resource: Ruby version compatibility information
-    class RubyVersionCompatibilityResource < MCP::Resource
+    class RubyVersionCompatibilityResource < FastMcp::Resource
       uri "rubygems://ruby/compatibility"
       resource_name "Ruby Version Compatibility"
       description "Information about Ruby version compatibility and release dates"
       mime_type "application/json"
 
-      def default_content
+      def content
         client = Client.new
         ruby_versions = client.get_ruby_versions(limit: 20, sort: :version_desc)
         latest = client.get_latest_ruby_version
@@ -402,13 +418,13 @@ module RubygemsMcp
     end
 
     # Resource: Ruby maintenance status for all versions
-    class RubyMaintenanceStatusResource < MCP::Resource
+    class RubyMaintenanceStatusResource < FastMcp::Resource
       uri "rubygems://ruby/maintenance"
       resource_name "Ruby Maintenance Status"
       description "Detailed maintenance status for all Ruby versions including EOL dates and maintenance phases"
       mime_type "application/json"
 
-      def default_content
+      def content
         client = Client.new
         maintenance_status = client.get_ruby_maintenance_status
 
@@ -428,13 +444,13 @@ module RubygemsMcp
     end
 
     # Resource: Latest Ruby version
-    class LatestRubyVersionResource < MCP::Resource
+    class LatestRubyVersionResource < FastMcp::Resource
       uri "rubygems://ruby/latest"
       resource_name "Latest Ruby Version"
       description "The latest stable Ruby version with release date"
       mime_type "application/json"
 
-      def default_content
+      def content
         client = Client.new
         latest = client.get_latest_ruby_version
         JSON.pretty_generate(latest)

data/lib/rubygems_mcp/version.rb

@@ -1,3 +1,3 @@
 module RubygemsMcp
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/sig/rubygems_mcp.rbs

@@ -59,7 +59,7 @@ module RubygemsMcp
     ) -> Array[Hash[Symbol, (String | nil)]]
 
     # Get changelog for a Ruby version
-    def get_ruby_version_changelog: (String version) -> Hash[Symbol, (String | nil)]
+    def get_ruby_version_changelog: (String version) -> Hash[Symbol, (String | nil)] # Returns :version, :release_notes_url, :content
 
     # Get reverse dependencies (gems that depend on this gem)
     def get_gem_reverse_dependencies: (String gem_name) -> Array[String]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubygems_mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Andrei Makarov
@@ -13,16 +13,22 @@ dependencies:
   name: fast-mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement