BundlerMCP

BundlerMCP

An MCP server for querying Ruby Gemfile dependencies

19
Stars
2
Forks
19
Watchers
0
Issues
BundlerMCP is a Model Context Protocol (MCP) server that allows AI agents to query information about dependencies in a Ruby project's Gemfile. Built on fast-mcp, it exposes tools to list all bundled Ruby gems or get detailed information about a specific gem, including version, description, documentation links, and installation details. Users can configure the server for their development setup, and it provides integrations for clients like Claude and Cursor as well as compatibility with the MCP Inspector. It supports logging and custom Gemfile paths via environment variables for flexible usage.

Key Features

MCP server implementation for Ruby projects
Lists all gems and their metadata from Gemfile
Retrieves detailed information about individual gems
Integration with AI model agents and development tools
Customizable via environment variables (e.g., for logging, Gemfile location)
Supports binstubs for straightforward client execution
Documentation available via RubyDoc
Testable using MCP Inspector tool
CI and gem publishing workflow support
Supports troubleshooting through configurable logging

Use Cases

Allowing AI agents to understand and interact with a project's Ruby dependencies
Automating code understanding and contextualization tasks for Ruby projects
Providing detailed gem information to enhance AI-driven code assistants
Surfacing project dependency data for review, audits, or insight generation
Facilitating smart code completion or refactoring tools that depend on gem metadata
Automated documentation generation involving dependency information
Enabling dependency graph analysis or visualization through structured endpoints
Improving project onboarding by surfacing contextual gem details to team members
Supporting IDE plugins to offer gem context on demand
Assisting in troubleshooting or support by accessing up-to-date dependency information

README

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.

CI Gem Version

Installation

Install the gem and add to the application's Gemfile by executing:

bash
bundle add bundler_mcp --group=development

Usage

  1. Generate the binstub:
bash
bundle binstubs bundler_mcp
  1. Configure your client to execute the binstub. Here are examples that work for Claude and Cursor:

Basic Example (mcp.json)

json
{
  "mcpServers": {
    "bundler-mcp": {
      "command": "/Users/mike/my_project/bin/bundler_mcp"
    }
  }
}

Example with logging and explicit Gemfile

json
{
  "mcpServers": {
    "bundler-mcp": {
      "command": "/Users/mike/my_project/bin/bundler_mcp",

      "env": {
        "BUNDLER_MCP_LOG_FILE": "/Users/mike/my_project/log/mcp.log",
        "BUNDLE_GEMFILE": "/Users/mike/my_project/subdir/Gemfile"
      }
    }
  }
}

Documentation

Available on RubyDoc

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 and CHANGELOG)

list_project_gems tool

get_gem_details

Retrieves detailed information about a specific gem, including:

  • Version
  • Description
  • Installation path
  • Top-level documentation locations
  • Source code file locations

get_gem_details tool

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:

bash
# Basic usage
npx @modelcontextprotocol/inspector ./bin/bundler_mcp

# With logging enabled
BUNDLER_MCP_LOG_FILE=/tmp/log/mcp.log npx @modelcontextprotocol/inspector ./bin/bundler_mcp

# With custom Gemfile
BUNDLE_GEMFILE=./other/Gemfile npx @modelcontextprotocol/inspector ./bin/bundler_mcp

Release Process

To install this gem onto your local machine, run bundle exec rake install. To release a new version:

  1. Update the version number in version.rb
  2. 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

Mike Subelsky

Star History

Star History Chart

Repository Owner

subelsky
subelsky

User

Repository Details

Language Ruby
Default Branch main
Size 1,138 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Ruby
99.67%
Shell
0.33%

Tags

Topics

bundler mcp ruby

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Maven Tools MCP Server

    Maven Tools MCP Server

    Universal Maven Central dependency intelligence server for JVM build tools via the Model Context Protocol.

    Maven Tools MCP Server provides an MCP-compliant API delivering rich Maven Central dependency intelligence for JVM build tools like Maven, Gradle, SBT, and Mill. It enables AI assistants to instantly analyze, interpret, and recommend updates, health checks, and maintenance insights by reading maven-metadata.xml directly from Maven Central. With Context7 integration, it supports orchestration and documentation, enabling bulk analysis, stable version filtering, risk assessment, and rapid cached responses. Designed for seamless integration into AI workflows via the Model Context Protocol.

    • 14
    • MCP
    • arvindand/maven-tools-mcp
  • Modbus MCP Server

    Modbus MCP Server

    Standardizes Modbus data for seamless AI integration via the Model Context Protocol.

    Modbus MCP Server provides an MCP-compliant interface that standardizes and contextualizes Modbus device data for use with AI agents and industrial IoT systems. It supports flexible Modbus connections over TCP, UDP, or serial interfaces and offers a range of Modbus tools for reading and writing registers and coils. With customizable prompts and structured tool definitions, it enables natural language-driven interactions and analysis of Modbus data within AI workflows. The solution is designed to ensure interoperability and easy configuration within MCP-compatible environments.

    • 18
    • MCP
    • kukapay/modbus-mcp
  • Codex MCP Server

    Codex MCP Server

    An MCP-compatible server delivering enriched blockchain data for AI models.

    Codex MCP Server implements the Model Context Protocol to provide enriched blockchain data from Codex. It is compatible with MCP clients such as Claude Desktop and Claude CLI, allowing seamless integration in AI workflows that require blockchain context. Users can run the server locally or via npx, and configure it for various MCP-compatible tools using their Codex API key.

    • 20
    • MCP
    • Codex-Data/codex-mcp
  • Homebrew MCP Python Server

    Homebrew MCP Python Server

    Expose Homebrew management as MCP tools for integration with AI clients.

    Homebrew MCP Python Server provides an MCP-compliant interface to manage Homebrew packages on macOS via a Python-based server. It enables standardized control of Homebrew commands through the Model Context Protocol, supporting integration with Claude Desktop, Cursor, and other MCP-compatible clients. The server operates via stdio using JSON-RPC 2.0, logs all interactions, and offers a declarative Python implementation. It is designed for seamless tool-chaining, advanced context management, and easy integration into LLM-driven environments.

    • 18
    • MCP
    • jeannier/homebrew-mcp
  • LLM Context

    LLM Context

    Reduce friction when providing context to LLMs with smart file selection and rule-based filtering.

    LLM Context streamlines the process of sharing relevant project files and context with large language models. It employs smart file selection and customizable rule-based filtering to ensure only the most pertinent information is provided. The tool supports Model Context Protocol (MCP), allowing AI models to access additional files seamlessly through standardized commands. Integration with MCP enables instant project context sharing during AI conversations, enhancing productivity and collaboration.

    • 283
    • MCP
    • cyberchitta/llm-context.py
  • Box MCP Server (Remote)

    Box MCP Server (Remote)

    Securely connect AI agents to Box content and Box AI using the Model Context Protocol.

    Box MCP Server (Remote) enables AI agent platforms to securely interact with Box data and AI-powered tools via the Model Context Protocol. It supports OAuth-based authentication and provides various capabilities, including user identification, file and folder operations, and access to Box AI tools. The service exposes an endpoint for easy integration by MCP-compatible clients while ensuring data never leaves the Box environment. It offers both admin console and developer console setup options and comprehensive documentation for connection.

    • 0
    • MCP
    • box/mcp-server-box-remote
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results