# ruby-mcp-client

> This is a Ruby implementation of MCP (Model Context Protocol) client

- **URL**: https://www.freshcrate.ai/projects/ruby-mcp-client
- **Author**: simonx1
- **Category**: MCP Servers
- **Latest version**: `1.0.1` (2026-03-22)
- **License**: MIT
- **Source**: https://github.com/simonx1/ruby-mcp-client
- **Language**: Ruby
- **GitHub**: 103 stars, 12 forks
- **Registry**: github
- **Tags**: `ruby`

## Description

This is a Ruby implementation of MCP (Model Context Protocol) client

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `1.0.1` | 2026-03-22 | Medium | ## 1.0.1 (2026-03-22)  ### New Features  #### OAuth 2.1 Enhancements - **Supported Scopes Discovery**: New `supported_scopes` method on `OAuthProvider` and `scope: :all` shorthand to request all server-advertised scopes (#109) - **Extra Client Metadata in DCR**: Dynamic client registration now supports optional OIDC metadata fields (`client_name`, `client_uri`, `logo_uri`, `tos_uri`, `policy_uri`, `contacts`) (#110) - **PKCE Serialization**: `PKCE#to_h` and `PKCE.from_h` methods for persi |
| `1.0.0` | 2026-02-15 | Low | ## 1.0.0 (2026-02-15)  ### MCP 2025-11-25 Protocol Support  Full implementation of the **MCP 2025-11-25** specification, upgrading from 2025-06-18.  #### New Protocol Features - **Audio Content**: Support for audio content type in tool results and messages (#82) - **Resource Annotations**: Added `lastModified` field to resource annotations (#83) - **Enhanced Tool Annotations**: Hint-style annotation API (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) alongside leg |
| `0.9.1` | 2025-12-10 | Low | ### New Features  #### Simplified API - `MCPClient.connect(url)` - **New single entry point** that auto-detects transport based on URL patterns (#62)   - `MCPClient.connect('http://localhost:8000/sse')` → SSE transport   - `MCPClient.connect('http://localhost:8931/mcp')` → Streamable HTTP transport   - `MCPClient.connect('npx -y @modelcontextprotocol/server-filesystem /home')` → stdio transport   - Supports options: `headers`, `read_timeout`, `sampling_handler`, etc.   - Multiple servers |
| `0.9.0` | 2025-11-05 | Low | ## 0.9.0 (2025-11-05)  ### MCP Protocol Update - **Updated to MCP 2025-06-18**: Latest protocol specification   - Protocol version constant updated from `2025-03-26` to `2025-06-18`   - All documentation and code comments updated to reference 2025-06-18   - Maintains full backward compatibility with previous versions  ### New Features  #### Streamable HTTP Gzip Support - Added gzip compression support for streamable HTTP transport (by @purposemc) (#46)  #### Browser-based OAuth flow |
| `0.8.1` | 2025-09-17 | Low | ## 0.8.1 (2025-09-17)  ### Breaking Changes - **Resources API**: Updated resources implementation to fully comply with MCP specification   - `list_resources` now returns `{ 'resources' => [...], 'nextCursor' => ... }` hash format on both client and server levels   - `read_resource` now returns array of `ResourceContent` objects instead of hash with 'contents' key  ### New Features - **Full MCP Resources Specification Compliance**:   - Added `ResourceContent` class for structured content |
| `0.8.0` | 2025-09-16 | Low | ## 0.8.0 (2025-09-16)  ### New Features - **MCP Prompts and Resources Support**: Added full support for MCP prompts and resources (#31)   - Implemented `list_prompts` and `get_prompt` methods for prompt management   - Implemented `list_resources` and `read_resource` methods for resource access   - Added support for both text and blob resource types  ### Bug Fixes - **Tool Caching**: Fixed issue with caching tools that have the same name from different servers (#342ff55)   - Tools are n |
| `0.7.3` | 2025-09-01 | Low | ## 0.7.3 (2025-09-01)  ### Bug Fixes - **Streaming JSON Parsing**: Fixed streaming JSON parsing improvements for better handling of partial data chunks - **SSE Connection**: Enhanced server-sent events connection reliability for real-time notifications (ty @dsablic )  ### Dependencies - Updated faraday from 2.13.1 to 2.13.4 - Updated ruby-openai from 8.1.0 to 8.3.0 (dev dependency) - Updated openai gem to latest version (dev dependency) - Updated rdoc from 6.14.1 to 6.14.2 (dev depende |
| `0.7.2` | 2025-07-14 | Low | ### Bug Fixes - **JSON-RPC Parameter Handling**: Fixed SSE transport compatibility with Playwright MCP servers by reverting JSON-RPC parameter handling to not send `null` for empty parameters - **Logger Formatter Preservation**: Fixed issue where custom logger formatters were being overridden in server implementations  ### Transport Improvements - **HTTP Redirect Support**: Added automatic redirect following (up to 3 hops) for both SSE and HTTP transports via faraday-follow_redirects gem |
| `0.7.1` | 2025-06-20 | Low | ## 0.7.1 (2025-06-20)  ### OAuth 2.1 Authentication Framework - Added comprehensive OAuth 2.1 support with PKCE for secure authentication - Implemented automatic authorization server discovery via `.well-known` endpoints - Added dynamic client registration when supported by servers - Implemented token refresh and automatic token management - Added pluggable storage backends for tokens and client credentials - Created `MCPClient::OAuthClient` utility class for easy OAuth-enabled server cr |
| `0.7.0` | 2025-06-18 | Low | ## 0.7.0 (2025-05-20)  ### What's New  - **StreamableHTTP transport type handling** - Enhanced HTTP transport layer with improved streaming capabilities - **Connection reliability improvements** - Fixed reconnection attempt resets on successful connections - **Test coverage enhancements** - Added verification for nested array removal operations - **Integration testing updates** - Improved integration test specifications  ### Bug Fixes  - Fixed reset reconnect attempts on success to en |

## Citation

- HTML: https://www.freshcrate.ai/projects/ruby-mcp-client
- Markdown: https://www.freshcrate.ai/projects/ruby-mcp-client.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ruby-mcp-client/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._