rubygems_mcp 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 263030b634fd9d87f2a5d3d4ff68574e017438ec57a7caff2ebc0b5729dfccb2
-  data.tar.gz: 8c9e6142f7c8c7cbb6695c5265c2a7655eb7606872963ec0db3bf5ffb9a7d140
+  metadata.gz: a1d6300f5e71b96d4ef7df1909e03c52555440cf794bc8afb46f5b1e6f75310e
+  data.tar.gz: 1727f6cbf963a35862eec6557da0d7008ea6fac4714614d2305aca1aec93a24c
 SHA512:
-  metadata.gz: 0f6bc852cf223da1499bf87063b2f92acbc562d40b4bd7d7fdfd8a4af38bf79064616fb8c0275b50e1e1e148a390cf92fcbdd0547cd3d45ca96d7ccf6966c1ec
-  data.tar.gz: 3ae00927439ed56b949e3d2a3ffa3830d87e3ee89d34d6e62adad8af51e7df54a33f2af870ee4b657b80300d335528b7627c8a2d986375a9a8aab7a81ce79516
+  metadata.gz: b4e6bf57c3302cac5c5c74e99b0060e12b192befec7d7007c36e81d41dd45f2892f12eb73e315a7502c29686ef38abbd0f652012ee9e310ca38eb96729590182
+  data.tar.gz: a756f8c5da8e2a7d36e4c9e1c07427a102e9ca97fae9ba895ff41ecfa37c4449d14c26e6991b656b74686cfa36ad9bfcfa42145136f9cd2ab72fb40d505ad614

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## 0.1.4 (2025-11-26)
+
+- Add `get_news_releases` tool to fetch all new gem releases from RubyGems.org with pagination (fetches from `/news?page=N`)
+- Add `get_popular_releases` tool to fetch popular new gem releases from RubyGems.org with pagination (fetches from `/releases/popular?page=N`)
+- Add pagination support for `search_gems` tool via `page` parameter (converts page to offset automatically)
+- Remove old patch code: unused monkey patches for fast-mcp `send_error`
+
 ## 0.1.3 (2025-11-21)
 
 - Add Ruby roadmap tools: `get_ruby_roadmap` and `get_ruby_version_roadmap_details` for accessing Ruby version planning information from bugs.ruby-lang.org

data/README.md

@@ -30,12 +30,18 @@ For Cursor IDE, create or update `.cursor/mcp.json` in your project:
 {
   "mcpServers": {
     "rubygems": {
-      "command": "rubygems_mcp"
+      "command": "gem",
+      "args": ["exec", "rubygems_mcp"],
+      "env": {
+        "RUBY_VERSION": "3.4.7"
+      }
     }
   }
 }
 ```
 
+**Note**: Using `gem exec` ensures the correct Ruby version is used. If you're using a Ruby version manager like [mise](https://mise.jdx.dev/) or [rbenv](https://github.com/rbenv/rbenv), set the `RUBY_VERSION` environment variable to match your desired Ruby version. The `gem exec` command will automatically use the correct Ruby version based on your version manager configuration.
+
 ### Claude Desktop Configuration
 
 For Claude Desktop, edit the MCP configuration file:
@@ -47,7 +53,11 @@ For Claude Desktop, edit the MCP configuration file:
 {
   "mcpServers": {
     "rubygems": {
-      "command": "rubygems_mcp"
+      "command": "gem",
+      "args": ["exec", "rubygems_mcp"],
+      "env": {
+        "RUBY_VERSION": "3.4.7"
+      }
     }
   }
 }
@@ -214,6 +224,8 @@ recently_updated = client.get_recently_updated_gems(limit: 10)
 
 - `get_latest_gems(limit: 30)` - Get latest gems - most recently added gems to RubyGems.org
 - `get_recently_updated_gems(limit: 30)` - Get recently updated gems - most recently updated gem versions
+- `get_news_releases(page: 1)` - Get news releases - all new gem releases from RubyGems.org with pagination (fetches from `/news?page=N`)
+- `get_popular_releases(page: 1)` - Get popular releases - popular new gem releases from RubyGems.org with pagination (fetches from `/releases/popular?page=N`)
 
 ## MCP Server Integration
 
@@ -285,6 +297,14 @@ The MCP server provides the following tools:
 16. **get_ruby_version_github_changelog** - Get GitHub release changelog for a Ruby version from the ruby/ruby repository
    - Parameters: `version` (string, e.g., "3.4.7", "3.4.0")
 
+17. **get_news_releases** - Get news releases - all new gem releases from RubyGems.org with pagination
+   - Parameters: `page` (optional integer, default: 1) - Page number (1-based)
+   - Fetches from: `https://rubygems.org/news?page=N`
+
+18. **get_popular_releases** - Get popular releases - popular new gem releases from RubyGems.org with pagination
+   - Parameters: `page` (optional integer, default: 1) - Page number (1-based)
+   - Fetches from: `https://rubygems.org/releases/popular?page=N`
+
 ## MCP Resources
 
 The MCP server provides the following resources:

data/lib/rubygems_mcp/client.rb

@@ -23,6 +23,7 @@ module RubygemsMcp
 
     RUBYGEMS_API_BASE = "https://rubygems.org/api/v1"
     RUBYGEMS_API_V2_BASE = "https://rubygems.org/api/v2"
+    RUBYGEMS_BASE = "https://rubygems.org"
     RUBY_RELEASES_URL = "https://www.ruby-lang.org/en/downloads/releases/"
     RUBY_BRANCHES_URL = "https://www.ruby-lang.org/en/downloads/branches/"
     RUBY_ROADMAP_URL = "https://bugs.ruby-lang.org/projects/ruby-master/roadmap"
@@ -1061,9 +1062,17 @@ module RubygemsMcp
     # @param query [String] Search query
     # @param limit [Integer, nil] Maximum number of results to return (nil = all)
     # @param offset [Integer] Number of results to skip (for pagination)
+    # @param page [Integer, nil] Page number (1-based). If provided, overrides offset (page 1 = offset 0, page 2 = offset 30, etc.)
     # @return [Array<Hash>] Array of hashes with gem information
-    def search_gems(query, limit: nil, offset: 0)
+    def search_gems(query, limit: nil, offset: 0, page: nil)
       raise ValidationError, "Search query cannot be empty" if query.nil? || query.strip.empty?
+
+      # Convert page to offset if provided (assuming 30 items per page, which is RubyGems default)
+      if page
+        raise ValidationError, "Page must be positive" if page < 1
+        offset = (page - 1) * 30
+      end
+
       validate_pagination_params(limit: limit, offset: offset)
       # Don't cache search results as they can change frequently
       uri = URI("#{RUBYGEMS_API_BASE}/search.json")
@@ -1089,6 +1098,149 @@ module RubygemsMcp
       results
     end
 
+    # Get news releases (all new gem releases) with pagination
+    #
+    # @param page [Integer] Page number (1-based, default: 1)
+    # @return [Array<Hash>] Array of hashes with gem release information
+    def get_news_releases(page: 1)
+      raise ValidationError, "Page must be positive" if page < 1
+      cache_key = "news_releases:#{page}"
+
+      if @cache_enabled
+        cached = self.class.cache.get(cache_key)
+        return cached if cached
+      end
+
+      uri = URI("#{RUBYGEMS_BASE}/news")
+      uri.query = URI.encode_www_form(page: page) if page > 1
+
+      response = make_request(uri, parse_html: true)
+      return [] unless response
+
+      releases = []
+      # RubyGems news page structure: each gem release is in a list item or similar structure
+      # Look for gem links and extract information
+      response.css("a[href^='/gems/']").each do |link|
+        gem_name = link["href"].match(%r{/gems/([^/]+)})&.[](1)
+        next unless gem_name
+
+        # Find the parent container to extract version and date
+        container = link.ancestors.find { |e| e.name == "li" || e.name == "div" || e.name == "article" }
+        next unless container
+
+        # Extract version from link text or nearby text
+        version_match = link.text.match(/v?(\d+\.\d+\.\d+)/)
+        version = version_match ? version_match[1] : nil
+
+        # Extract date (look for date patterns in nearby text)
+        date_text = container.text
+        date_match = date_text.match(/(\w+ \d{1,2}, \d{4})|(\d{4}-\d{2}-\d{2})/)
+        release_date = if date_match
+          begin
+            Date.parse(date_match[0]).iso8601
+          rescue Date::Error
+            nil
+          end
+        end
+
+        # Extract downloads count if available
+        downloads_match = container.text.match(/([\d,]+)\s*Downloads?/i)
+        downloads = downloads_match ? downloads_match[1].delete(",").to_i : nil
+
+        # Extract description/info
+        info_elem = container.css("p, .info, .description").first
+        info = info_elem&.text&.strip
+
+        # Avoid duplicates
+        next if releases.any? { |r| r[:name] == gem_name && r[:version] == version }
+
+        releases << {
+          name: gem_name,
+          version: version,
+          release_date: release_date,
+          downloads: downloads,
+          info: info,
+          gem_url: "#{RUBYGEMS_BASE}/gems/#{gem_name}"
+        }
+      end
+
+      # Cache for 15 minutes (news changes frequently)
+      self.class.cache.set(cache_key, releases, 900) if @cache_enabled
+
+      releases
+    end
+
+    # Get popular releases (popular new gem releases) with pagination
+    #
+    # @param page [Integer] Page number (1-based, default: 1)
+    # @return [Array<Hash>] Array of hashes with popular gem release information
+    def get_popular_releases(page: 1)
+      raise ValidationError, "Page must be positive" if page < 1
+      cache_key = "popular_releases:#{page}"
+
+      if @cache_enabled
+        cached = self.class.cache.get(cache_key)
+        return cached if cached
+      end
+
+      uri = URI("#{RUBYGEMS_BASE}/releases/popular")
+      uri.query = URI.encode_www_form(page: page) if page > 1
+
+      response = make_request(uri, parse_html: true)
+      return [] unless response
+
+      releases = []
+      # RubyGems popular releases page structure: similar to news page
+      response.css("a[href^='/gems/']").each do |link|
+        gem_name = link["href"].match(%r{/gems/([^/]+)})&.[](1)
+        next unless gem_name
+
+        # Find the parent container to extract version and date
+        container = link.ancestors.find { |e| e.name == "li" || e.name == "div" || e.name == "article" }
+        next unless container
+
+        # Extract version from link text or nearby text
+        version_match = link.text.match(/v?(\d+\.\d+\.\d+)/)
+        version = version_match ? version_match[1] : nil
+
+        # Extract date (look for date patterns in nearby text)
+        date_text = container.text
+        date_match = date_text.match(/(\w+ \d{1,2}, \d{4})|(\d{4}-\d{2}-\d{2})/)
+        release_date = if date_match
+          begin
+            Date.parse(date_match[0]).iso8601
+          rescue Date::Error
+            nil
+          end
+        end
+
+        # Extract downloads count if available
+        downloads_match = container.text.match(/([\d,]+)\s*Downloads?/i)
+        downloads = downloads_match ? downloads_match[1].delete(",").to_i : nil
+
+        # Extract description/info
+        info_elem = container.css("p, .info, .description").first
+        info = info_elem&.text&.strip
+
+        # Avoid duplicates
+        next if releases.any? { |r| r[:name] == gem_name && r[:version] == version }
+
+        releases << {
+          name: gem_name,
+          version: version,
+          release_date: release_date,
+          downloads: downloads,
+          info: info,
+          gem_url: "#{RUBYGEMS_BASE}/gems/#{gem_name}"
+        }
+      end
+
+      # Cache for 15 minutes (popular releases change frequently)
+      self.class.cache.set(cache_key, releases, 900) if @cache_enabled
+
+      releases
+    end
+
     # Validate gem name
     #
     # @param gem_name [String] Gem name to validate

data/lib/rubygems_mcp/server.rb

@@ -10,39 +10,6 @@ require "securerandom"
 # Alias MCP to FastMcp for compatibility
 FastMcp = MCP unless defined?(FastMcp)
 
-# Monkey-patch fast-mcp to ensure error responses always have a valid id
-# JSON-RPC 2.0 allows id: null for notifications, but MCP clients (Cursor/Inspector)
-# use strict Zod validation that requires id to be a string or number
-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)
-        # 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
-
 module RubygemsMcp
   # MCP Server for RubyGems integration
   #
@@ -134,6 +101,8 @@ module RubygemsMcp
       server.register_tool(GetRubyVersionRoadmapDetailsTool)
       server.register_tool(GetRubyVersionGithubChangelogTool)
       server.register_tool(GetGemVersionInfoTool)
+      server.register_tool(GetNewsReleasesTool)
+      server.register_tool(GetPopularReleasesTool)
     end
 
     def self.register_resources(server)
@@ -381,10 +350,41 @@ module RubygemsMcp
 
       arguments do
         required(:query).filled(:string).description("Search query (e.g., 'rails')")
+        optional(:page).filled(:integer).description("Page number (1-based). If provided, overrides offset")
+        optional(:limit).filled(:integer).description("Maximum number of results to return")
+        optional(:offset).filled(:integer).description("Number of results to skip (for pagination)")
+      end
+
+      def call(query:, page: nil, limit: nil, offset: 0)
+        get_client.search_gems(query, page: page, limit: limit, offset: offset)
+      end
+    end
+
+    # Get news releases (all new gem releases)
+    class GetNewsReleasesTool < BaseTool
+      tool_name "get_news_releases"
+      description "Get news releases - all new gem releases from RubyGems.org with pagination"
+
+      arguments do
+        optional(:page).filled(:integer).description("Page number (1-based, default: 1)")
       end
 
-      def call(query:)
-        get_client.search_gems(query)
+      def call(page: 1)
+        get_client.get_news_releases(page: page)
+      end
+    end
+
+    # Get popular releases (popular new gem releases)
+    class GetPopularReleasesTool < BaseTool
+      tool_name "get_popular_releases"
+      description "Get popular releases - popular new gem releases from RubyGems.org with pagination"
+
+      arguments do
+        optional(:page).filled(:integer).description("Page number (1-based, default: 1)")
+      end
+
+      def call(page: 1)
+        get_client.get_popular_releases(page: page)
       end
     end
 
@@ -430,39 +430,50 @@ module RubygemsMcp
       end
     end
 
-    # Resource: Popular Ruby gems list
+    # Resource: Popular Ruby gems list with real-time data
     class PopularGemsResource < FastMcp::Resource
       uri "rubygems://popular"
       resource_name "Popular Ruby Gems"
-      description "A curated list of popular Ruby gems with their latest versions"
+      description "Popular new gem releases from RubyGems.org with their versions, download counts, and metadata"
       mime_type "application/json"
 
       def content
         client = Client.new
-        popular_gems = %w[
-          rails nokogiri bundler rake rspec devise puma sidekiq
-          pg mysql2 redis json webrick sinatra haml sass
-          jekyll octokit faraday httparty rest-client
-        ]
-
-        gems_data = popular_gems.map do |gem_name|
-          versions = client.get_gem_versions(gem_name, limit: 1, fields: ["name", "version", "release_date"])
-          latest = versions.first
-          if latest
-            result = latest.dup
-            result[:name] = gem_name
-            result
-          else
-            {name: gem_name, version: nil, release_date: nil}
-          end
-        rescue ResponseSizeExceededError, CorruptedDataError => e
-          # Skip gems that exceed size limit or have corrupted data
-          {name: gem_name, version: nil, release_date: nil, error: e.message}
+        # Get popular releases from the first 3 pages (up to ~30 gems)
+        all_releases = []
+        (1..3).each do |page|
+          releases = client.get_popular_releases(page: page)
+          break if releases.empty?
+          all_releases.concat(releases)
+        rescue
+          # If a page fails, continue with what we have
+          break
         end
 
-        # Filter out gems that weren't found (nil versions)
-        gems_data = gems_data.reject { |g| g[:version].nil? }
-        JSON.pretty_generate(gems_data)
+        # Limit to top 20 most popular by downloads
+        gems_data = all_releases
+          .select { |g| g[:downloads] && g[:downloads] > 0 }
+          .sort_by { |g| g[:downloads] || 0 }
+          .last(20).reverse
+          .map do |release|
+            {
+              name: release[:name],
+              version: release[:version],
+              release_date: release[:release_date],
+              downloads: release[:downloads],
+              info: release[:info],
+              gem_url: release[:gem_url]
+            }
+          end
+
+        result = {
+          updated_at: Time.now.iso8601,
+          total_gems: gems_data.length,
+          source: "rubygems.org/releases/popular",
+          gems: gems_data
+        }
+
+        JSON.pretty_generate(result)
       end
     end
 
@@ -528,17 +539,32 @@ module RubygemsMcp
       end
     end
 
-    # Resource: Latest Ruby version
+    # Resource: Latest Ruby version with additional context
     class LatestRubyVersionResource < FastMcp::Resource
       uri "rubygems://ruby/latest"
       resource_name "Latest Ruby Version"
-      description "The latest stable Ruby version with release date"
+      description "The latest stable Ruby version with release date, maintenance status, and compatibility information"
       mime_type "application/json"
 
       def content
         client = Client.new
         latest = client.get_latest_ruby_version
-        JSON.pretty_generate(latest)
+        maintenance_status = client.get_ruby_maintenance_status
+
+        # Find maintenance info for the latest version
+        latest_major_minor = latest[:version]&.match(/^(\d+\.\d+)/)&.[](1)
+        maintenance_info = maintenance_status.find { |m| m[:version] == latest_major_minor } if latest_major_minor
+
+        result = {
+          version: latest[:version],
+          release_date: latest[:release_date],
+          maintenance_status: maintenance_info&.dig(:status),
+          normal_maintenance_until: maintenance_info&.dig(:normal_maintenance_until),
+          eol: maintenance_info&.dig(:eol),
+          updated_at: Time.now.iso8601
+        }
+
+        JSON.pretty_generate(result)
       end
     end
   end

data/lib/rubygems_mcp/version.rb

@@ -1,3 +1,3 @@
 module RubygemsMcp
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubygems_mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Andrei Makarov