mcpField
B
BundlerMCP

BundlerMCP

本地服务
rubygems.org开发工具2169 周前更新
代码仓库访问官网

关于 BundlerMCP

BundlerMCP 是一个 MCP 服务，使 AI Agent 能查询 Ruby 项目 Gemfile 中 gem 的信息，包括版本、描述和源代码位置。它基于 fast-mcp 构建，面向 Ruby 开发者。

主要功能

  1. 01list_project_gems 列出项目中的 gem
  2. 02get_gem_details 查询单个 gem 的详细信息
  3. 03返回版本、描述与安装路径
  4. 04提供 README、CHANGELOG 等文档位置
  5. 05支持日志文件与自定义 Gemfile 路径

适用场景

  1. 01AI Agent 查询 Ruby 项目依赖的 gem 信息
  2. 02定位某个 gem 的源代码与文档文件

MCP 相关

该服务通过 list_project_gems 与 get_gem_details 两个工具向 MCP 客户端提供 Gemfile 依赖信息。客户端通过运行 bin 目录下的 binstub 启动服务。

#ruby#bundler#mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "bundler_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

BundlerMCP

一个模型上下文协议（MCP）服务，可让 AI Agent 查询 Ruby 项目 Gemfile 中依赖项的信息。使用 fast-mcp 构建。

CI Gem 版本

安装

执行以下命令安装 gem 并将其添加到应用的 Gemfile 中：

bundle add bundler_mcp --group=development

用法

  1. 生成 binstub：
bundle binstubs bundler_mcp
  1. 配置客户端以执行 binstub。以下是适用于 Claude 和 Cursor 的示例：
基本示例（mcp.json）
{
  "mcpServers": {
    "bundler-mcp": {
      "command": "/Users/mike/my_project/bin/bundler_mcp"
    }
  }
}
启用日志记录并显式指定 Gemfile 的示例
{
  "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"
      }
    }
  }
}
文档

可在 RubyDoc 上查看

可用工具

该服务为 AI Agent 提供两个工具：

list_project_gems

列出所有已打包的 Ruby gem，包括：

  • 版本
  • 描述
  • 安装路径
  • 顶层文档位置（例如 README 和 CHANGELOG）

list_project_gems 工具

get_gem_details

获取特定 gem 的详细信息，包括：

  • 版本
  • 描述
  • 安装路径
  • 顶层文档位置
  • 源代码文件位置

get_gem_details 工具

环境变量

  • BUNDLE_GEMFILE：Bundler 用于定位 Gemfile。如果使用用法部分介绍的 binstub 方法，通常无需设置此变量。
  • BUNDLER_MCP_LOG_FILE：日志文件路径。可用于故障排查（默认为不记录日志）

开发

检出仓库后，运行 bin/setup 安装依赖，并运行 bundle exec rspec 执行测试。也可以运行 bin/console 启动交互式提示，以便进行试验。

使用 MCP Inspector 测试

你可以使用 MCP inspector 直接测试该服务：

# 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
发布流程

运行 bundle exec rake install 将此 gem 安装到本地计算机。要发布新版本：

  1. 更新 version.rb 中的版本号
  2. 运行 bundle exec rake release

这将：

  • 为该版本创建 git 标签
  • 推送 git 提交和创建的标签
  • 将 .gem 文件推送到 rubygems.org

贡献

欢迎在 GitHub 上提交 Bug 报告和拉取请求：https://github.com/subelsky/bundler_mcp。

许可证

根据 MIT 许可证开源。

作者

Mike Subelsky

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。