rubygems_mcp 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 263030b634fd9d87f2a5d3d4ff68574e017438ec57a7caff2ebc0b5729dfccb2
-  data.tar.gz: 8c9e6142f7c8c7cbb6695c5265c2a7655eb7606872963ec0db3bf5ffb9a7d140
+  metadata.gz: 792f4e1e9055f0daca5acf09de1b71cdaa64a203808f9f71463d5cb7d67544e1
+  data.tar.gz: cc8a4b2af63e9b96534aae1aee6aeeb572fee2fd602d1d648d29b50c391fb9e5
 SHA512:
-  metadata.gz: 0f6bc852cf223da1499bf87063b2f92acbc562d40b4bd7d7fdfd8a4af38bf79064616fb8c0275b50e1e1e148a390cf92fcbdd0547cd3d45ca96d7ccf6966c1ec
-  data.tar.gz: 3ae00927439ed56b949e3d2a3ffa3830d87e3ee89d34d6e62adad8af51e7df54a33f2af870ee4b657b80300d335528b7627c8a2d986375a9a8aab7a81ce79516
+  metadata.gz: 5383415d5d7963b119273f486dca440c5af64e490065abfeaab9e3f9d21e03297cf3f0931252909f8fa2ba9d7e777c11101dcf483840ad70a9f1a6a3a96db816
+  data.tar.gz: ba60b3179ad4956457c4cd22e758e3a93a4f9ce4347697c899459003fc4002555077d8d56c0af525c7f0f8d74010fe5148c1ae4e6fb88d2b611e4f2177d28481

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # CHANGELOG
 
+## Unreleased
+
+## 0.2.0 (2026-09-08)
+
+- BREAKING: Require Ruby 3.4
+- BREAKING: Raise `fast-mcp` to `>= 1.6` and `nokogiri` to `~> 1.19`
+- BREAKING: `search_gems` paginates with `limit` and `offset` on the first search page
+- BREAKING: Raise when an MCP version tool receives an invalid sort order
+- Fetch gem changelogs only over HTTPS from GitHub, GitLab, RubyGems, and ruby-lang.org hosts
+- Include the changelog source host on fetch results
+- Read latest gem versions from gem info and keep rows whose dates fail to parse
+- Skip caching empty Ruby changelogs after a GitHub fetch failure
+- Stop reading HTTP bodies whose Content-Length exceeds 5MB
+- Cap the in-memory response cache
+- Paginate and cache the Ruby versions list on first fetch
+- Apply the HTTP size limit to GitHub Ruby changelogs
+- Limit latest-version lookups to 20 gem names
+
+## 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
@@ -53,4 +78,3 @@
 - Comprehensive test suite with RSpec, VCR cassettes, and WebMock
 - Requires Ruby 3.1 or higher
 - All dependencies use latest compatible versions with pessimistic versioning for security
-

data/README.md

@@ -1,6 +1,6 @@
 # rubygems_mcp
 
-[![Gem Version](https://badge.fury.io/rb/rubygems_mcp.svg?v=0.1.3)](https://badge.fury.io/rb/rubygems_mcp) [![Test Status](https://github.com/amkisko/rubygems_mcp.rb/actions/workflows/test.yml/badge.svg)](https://github.com/amkisko/rubygems_mcp.rb/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/amkisko/rubygems_mcp.rb/graph/badge.svg?token=APQ6AK7EC9)](https://codecov.io/gh/amkisko/rubygems_mcp.rb)
+[![Gem Version](https://badge.fury.io/rb/rubygems_mcp.svg?v=0.2.0)](https://badge.fury.io/rb/rubygems_mcp) [![Test Status](https://github.com/amkisko/rubygems_mcp.rb/actions/workflows/test.yml/badge.svg)](https://github.com/amkisko/rubygems_mcp.rb/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/amkisko/rubygems_mcp.rb/graph/badge.svg?token=APQ6AK7EC9)](https://app.codecov.io/github/amkisko/rubygems_mcp.rb) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=amkisko_rubygems_mcp.rb&metric=alert_status)](https://sonarcloud.io/project/overview?id=amkisko_rubygems_mcp.rb)
 
 Ruby gem providing RubyGems and Ruby version information via MCP (Model Context Protocol) server tools. Integrates with MCP-compatible clients like Cursor IDE, Claude Desktop, and other MCP-enabled tools.
 
@@ -14,7 +14,7 @@ Sponsored by [Kisko Labs](https://www.kiskolabs.com).
 
 ## Requirements
 
-- **Ruby 3.1 or higher** (Ruby 3.0 and earlier are not supported)
+- **Ruby 3.4 or higher**
 
 ## Quick Start
 
@@ -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"
+      }
     }
   }
 }
@@ -93,7 +103,7 @@ The server will start and communicate via STDIN/STDOUT using the MCP protocol.
 
 - **RubyGems API Client**: Full-featured client for RubyGems REST API with comprehensive endpoint coverage
 - **Ruby Version Information**: Fetch Ruby release information, changelogs, and maintenance status from ruby-lang.org
-- **MCP Server Integration**: Ready-to-use MCP server with 19 tools and 4 resources, compatible with Cursor IDE, Claude Desktop, and other MCP-enabled tools
+- **MCP Server Integration**: Ready-to-use MCP server with 18 tools and 4 resources, compatible with Cursor IDE, Claude Desktop, and other MCP-enabled tools
 - **Pagination & Sorting**: Support for large result sets with customizable pagination and sorting options
 - **Caching**: In-memory caching with configurable TTL for improved performance
 - **Error Handling**: Graceful error handling with custom exceptions and response size limits
@@ -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
 
@@ -274,7 +286,7 @@ The MCP server provides the following tools:
    - Parameters: `gem_name` (string), `version` (optional string, uses latest if not provided)
 
 13. **search_gems** - Search for gems by name on RubyGems
-   - Parameters: `query` (string)
+   - Parameters: `query` (string), `limit` (optional integer), `offset` (optional integer)
 
 14. **get_ruby_roadmap** - Get Ruby roadmap information from bugs.ruby-lang.org showing planned versions and their issues
    - Parameters: none
@@ -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:
@@ -307,10 +327,7 @@ The MCP server provides the following resources:
 
 ## Error Handling
 
-The client handles errors gracefully:
-- Returns empty arrays for failed requests
-- Returns empty hashes for failed gem info requests
-- Handles network errors and JSON parsing errors
+HTTP failures raise `NotFoundError`, `ServerError`, or `APIError`. Unreadable JSON or HTML raises `CorruptedDataError`. Bodies over 5MB raise `ResponseSizeExceededError`. Invalid input, including more than 20 names on `get_latest_versions`, raises `ValidationError`.
 
 ## Development
 
@@ -352,6 +369,18 @@ For more information, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 If you discover a security vulnerability, please report it responsibly. See [SECURITY.md](SECURITY.md) for details.
 
+## Links
+
+- [GitHub](https://github.com/amkisko/rubygems_mcp.rb)
+- [GitLab](https://gitlab.com/amkisko/rubygems_mcp.rb)
+- [RubyGems](https://rubygems.org/gems/rubygems_mcp)
+- [libraries.io](https://libraries.io/rubygems/rubygems_mcp)
+- [Deps.dev](https://deps.dev/rubygems/rubygems_mcp)
+- [SonarCloud](https://sonarcloud.io/project/overview?id=amkisko_rubygems_mcp.rb)
+- [Snyk](https://snyk.io/test/github/amkisko/rubygems_mcp.rb)
+- [Codecov](https://app.codecov.io/github/amkisko/rubygems_mcp.rb)
+- [OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/amkisko/rubygems_mcp.rb)
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/rubygems_mcp/cache.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module RubygemsMcp
+  class Cache
+    MAX_ENTRIES = 256
+
+    def initialize(max_entries: MAX_ENTRIES)
+      @cache = {}
+      @mutex = Mutex.new
+      @inflight = {}
+      @max_entries = max_entries
+    end
+
+    def get(key)
+      @mutex.synchronize { read_unlocked(key) }
+    end
+
+    def set(key, value, ttl_seconds)
+      @mutex.synchronize { write_unlocked(key, value, ttl_seconds) }
+    end
+
+    def fetch(key, ttl_seconds)
+      cached = get(key)
+      return cached unless cached.nil?
+
+      lock = @mutex.synchronize { @inflight[key] ||= Mutex.new }
+      lock.synchronize do
+        cached = get(key)
+        return cached unless cached.nil?
+
+        value = yield
+        set(key, value, ttl_seconds)
+        value
+      ensure
+        @mutex.synchronize { @inflight.delete(key) if @inflight[key].equal?(lock) }
+      end
+    end
+
+    def clear
+      @mutex.synchronize do
+        @cache.clear
+        @inflight.clear
+      end
+    end
+
+    def size
+      @mutex.synchronize { @cache.size }
+    end
+
+    private
+
+    def read_unlocked(key)
+      entry = @cache[key]
+      return nil unless entry
+
+      if entry[:expires_at] < Time.now
+        @cache.delete(key)
+        return nil
+      end
+
+      entry[:value]
+    end
+
+    def write_unlocked(key, value, ttl_seconds)
+      evict_unlocked if @cache.size >= @max_entries && !@cache.key?(key)
+      @cache.delete(key)
+      @cache[key] = {value: value, expires_at: Time.now + ttl_seconds}
+    end
+
+    def evict_unlocked
+      now = Time.now
+      @cache.delete_if { |_key, entry| entry[:expires_at] < now }
+      @cache.shift while @cache.size >= @max_entries
+    end
+  end
+end