Provides tools for querying information about Ruby gem dependencies in a project's Gemfile, including listing all bundled gems with their versions and details, and retrieving specific gem information.
Enables inspection of Ruby gems from RubyGems.org that are bundled in a project, including versions, descriptions, installation paths, and documentation locations.
BundlerMCP
A Model Context Protocol (MCP) server enabling AI agents to query information about dependencies in a Ruby project's Gemfile
. Built with fast-mcp.
Installation
Install the gem and add to the application's Gemfile by executing:
Usage
- Generate the binstub:
- Configure your client to execute the binstub. Here are examples that work for Claude and Cursor:
Basic Example (mcp.json)
Example with logging and explicit Gemfile
Documentation
Available Tools
The server provides two tools for AI agents:
list_project_gems
Lists all bundled Ruby gems with their:
- Versions
- Descriptions
- Installation paths
- Top-level documentation locations (e.g.
README
andCHANGELOG
)
get_gem_details
Retrieves detailed information about a specific gem, including:
- Version
- Description
- Installation path
- Top-level documentation locations
- Source code file locations
Environment Variables
BUNDLE_GEMFILE
: Used by Bundler to locate your Gemfile. If you use the binstub method described in the Usage section, this is usually not needed.BUNDLER_MCP_LOG_FILE
: Path to log file. Useful for troubleshooting (defaults to no logging)
Development
After checking out the repo, run bin/setup
to install dependencies and bundle exec rspec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
Testing with the MCP Inspector
You can test the server directly using the MCP inspector:
Release Process
To install this gem onto your local machine, run bundle exec rake install
. To release a new version:
- Update the version number in
version.rb
- Run
bundle exec rake release
This will:
- Create a git tag for the version
- Push git commits and the created tag
- Push the
.gem
file to rubygems.org
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/subelsky/bundler_mcp.
License
Open source under the terms of the MIT License.
Author
This server cannot be installed
Enables agents to query information about gems in a Ruby project's Gemfile, including source code and metadata.
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with the Metal Framework by providing documentation search and code generation capabilities using natural language queries.Last updated -22TypeScript
- AsecurityAlicenseAqualityProvides tools for listing and retrieving content from different knowledge bases using semantic search capabilities.Last updated -210TypeScriptThe Unlicense
- -securityAlicense-qualityProvides programmatic search functionality for Obsidian vaults through a REST API interface, allowing external applications to search through notes and retrieve absolute paths to matching documents.Last updated -10PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that allows interaction with the RubyGems.org API to fetch metadata about Ruby packages, search gems, and explore dependencies and ownership information.Last updated -TypeScript