BundlerMCP

BundlerMCP

Ruby プロジェクトの Gemfile に含まれる依存関係の情報を AI エージェントが照会できる、Model Context Protocol（MCP）サーバーです。fast-mcp で構築されています。

インストール

次のコマンドを実行して gem をインストールし、アプリケーションの Gemfile に追加します。

bundle add bundler_mcp --group=development

使い方

1. binstub を生成します。

bundle binstubs bundler_mcp

2. 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 エージェント向けに 2 つのツールを提供します。

list_project_gems

以下の情報とともに、バンドルされているすべての Ruby gem を一覧表示します。

• バージョン
• 説明
• インストール先のパス
• トップレベルのドキュメントの場所（例：README と CHANGELOG）

get_gem_details

以下を含む、特定の gem の詳細情報を取得します。

• バージョン
• 説明
• インストール先のパス
• トップレベルのドキュメントの場所
• ソースコードファイルの場所

環境変数

• 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

リリース手順

この gem をローカルマシンにインストールするには、bundle exec rake install を実行します。新しいバージョンをリリースするには、次の手順に従います。

1. version.rb のバージョン番号を更新します
2. bundle exec rake release を実行します

これにより、以下が行われます。

• バージョンの git タグを作成します
• git のコミットと作成したタグをプッシュします
• .gem ファイルを rubygems.org にプッシュします

貢献

バグ報告やプルリクエストは、GitHub（https://github.com/subelsky/bundler_mcp）で歓迎します。

ライセンス

MIT License の条件に基づくオープンソースです。

作者

Mike Subelsky