Skip to content

Add basic http client support #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 22 commits into
base: main
Choose a base branch
from

Conversation

jcat4
Copy link
Contributor

@jcat4 jcat4 commented May 28, 2025

Motivation and Context

Closes #3

Follow-up to #27

Happy to close the other PR and just keep this one if we want.

This adds the ability to build MCP clients with the ruby sdk. I've started with a basic HTTP client. We can add other things (i.e. streamable HTTP) later.

For simplicity, I'm just allowing custom headers to specify auth. I didn't want to build an abstraction around different auth types prematurely.

How Has This Been Tested?

The local gem build has been tested in 2 different internal repositories and is working as expected so far.

Breaking Changes

Just the stuff from #27

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

Additional context

@jcat4 jcat4 marked this pull request as ready for review May 29, 2025 16:22
@jcat4 jcat4 marked this pull request as draft May 29, 2025 17:54
@jcat4
Copy link
Contributor Author

jcat4 commented May 29, 2025

Decided to build in auth, going to draft to test it

@jcat4
Copy link
Contributor Author

jcat4 commented May 29, 2025

Auth is tested and working

@jcat4 jcat4 marked this pull request as ready for review May 29, 2025 19:47
@topherbullock
Copy link
Contributor

@jcat4 can you rebase on main and resolve conflicts? seems to be largely the model_context_protocol => mcp rename

@atesgoral atesgoral mentioned this pull request Jun 15, 2025
@vickyonit
Copy link

Thank you for your work on this, @jcat4. We're looking forward to seeing it merged. Is there an expected timeline for this?

@jcat4
Copy link
Contributor Author

jcat4 commented Jun 19, 2025

@jcat4 can you rebase on main and resolve conflicts? seems to be largely the model_context_protocol => mcp rename

Sorry, lost track of this.

I thought we wanted to go with the pluggable approach? If so, I can close this

Or I can try to rework this to be closer to what y'all envisioned!

@atesgoral
Copy link
Contributor

@jcat4 @topherbullock Now that #27 is in, could we revisit this and get a client in there? 🙏

@jcat4
Copy link
Contributor Author

jcat4 commented Jul 29, 2025

@jcat4 @topherbullock Now that #27 is in, could we revisit this and get a client in there? 🙏

I'll make some time this week to knock this out

@jcat4 jcat4 marked this pull request as draft July 30, 2025 16:25
@jcat4 jcat4 force-pushed the add-basic-http-client-support branch from e72bcfa to 3a0b9b8 Compare July 30, 2025 16:30
@@ -216,7 +218,7 @@ $ ruby examples/stdio_server.rb
{"jsonrpc":"2.0","id":"2","method":"tools/list"}
```

## Configuration
### Configuration
Copy link
Contributor Author

@jcat4 jcat4 Jul 31, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At the moment, this is server-specific. If we have this patch a client config too (or stop having the config scoped to just the server), we can move this somewhere else in the README

@jcat4
Copy link
Contributor Author

jcat4 commented Jul 31, 2025

Unsure if we still feel strongly about going with a pluggable approach, and haven't had any feedback on that yet. Will put this as-is in for review

But please let me know if we should go somewhere else with the interface! I want us to get as close to right as possible on our first release

@jcat4 jcat4 marked this pull request as ready for review July 31, 2025 19:41
@jcat4
Copy link
Contributor Author

jcat4 commented Jul 31, 2025

I've tested the new code in one of our local apps, and it's working as expected.

@jcat4 jcat4 requested review from atesgoral and juharris July 31, 2025 19:42
@jcat4
Copy link
Contributor Author

jcat4 commented Jul 31, 2025

Spoke with @juharris, and we decided a pluggable approach would probably be better. The primary reason is it will allow folks to implement and pass their own custom transport layers (and open the door for other gems to add more, too!). The first step might be a bit manual (create your transport, create your client by passing your transport, send messages to your client), but we can iterate later with convenience wrappers that won't break existing code

Overall, it seems like the safer bet. What we have is functional, but maybe not flexible enough for a public gem. Will begin work on this again next week when I have time, I think I can knock something out relatively quickly

@@ -8,3 +8,6 @@
/spec/reports/
/tmp/
Gemfile.lock

# Mac stuff
.DS_Store
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❤️

@atesgoral
Copy link
Contributor

@jcat4 Thanks for doing this!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

client implementation
5 participants