quickstart-resources/mcp-client-ruby
Repository files (latest commit first)
Filename Latest commit message Latest commit date
olaservo d913f3a150 Add structured output to the Ruby weather server and client
The mcp gem 1.1.0 (2026-08-01) is the first to negotiate 2026-07-28, so the
Ruby examples can finally show the same thing the other four do: get_alerts
declares an array-rooted output_schema and returns a bare top-level JSON
array, get_forecast returns an object. Declaring `type:` at the root is what
suppresses the SDK object-root default.

Failure paths return an error result rather than a bare text one, because a
tool declaring an output_schema MUST return conforming structured content.
No alerts is an empty array, not an error.

The client compiles each declared schema at connect time and validates every
non-error result. The SDK client does not do this itself, so the spec
client-side SHOULD costs real code here, as it does in Go and Rust.

NOT READY TO SHIP. The gem never emits the `resultType` field that the
2026-07-28 schema marks mandatory, and no user-level knob sets it, so a
spec-strict client rejects every response including tools/list. Verified
end-to-end against the Ruby client, which does not check the field; blocked
against the TypeScript SDK client. See the server README.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-09 21:20:39 -07:00
..
.env.example Add Ruby MCP client example 2026-03-23 22:45:16 +09:00
client.rb Add structured output to the Ruby weather server and client 2026-08-09 21:20:39 -07:00
Gemfile Add structured output to the Ruby weather server and client 2026-08-09 21:20:39 -07:00
README.md Add structured output to the Ruby weather server and client 2026-08-09 21:20:39 -07:00

An LLM-Powered Chatbot MCP Client written in Ruby

See the Build an MCP client tutorial for more information.

Structured output

The spec says clients SHOULD validate structured results against the schema the tool declares, and this SDK's client does not do it for you — MCP::Client::Tool#output_schema hands back the raw schema from the wire and nothing checks results against it. So the client compiles each declared schema once at connect time with MCP::Tool::OutputSchema.new and validates every non-error result.

The two channels go to different readers: content is forwarded to the model, while structured_content is used as data — when a tool returns an array, the client counts its items rather than re-reading the prose. See Structured Content.

MCP::Client::Stdio offers 2026-07-28 by default, so no negotiation setup is needed here.