airbrake_mcp 1.0.3 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 722e5cf91d2f23f4723ce52aecf454c9e4dd6371e6388dbcd9d2dfb4703cf9f8
-  data.tar.gz: df24d6787c6ee9abb46783e58c87cc4b7c56a6999db39b657ee556099f7ca674
+  metadata.gz: e285107444c59dad9e1bf190b5533358d3b31d2d87555ab5b95e1973dce12bd9
+  data.tar.gz: d292168104b253d786fd1a735da199b77debbcfcbf8bb147f730d09daff28ff1
 SHA512:
-  metadata.gz: e078d5b0fb0435dd004ddb9ddf8654ac705a265469ea19025a8a01e7b9ea5cc1b6fde09ba457887efbafa54bf3f7386962ccd61497db9cc910f4bcbe77184b7b
-  data.tar.gz: 9fd4a9aefc16035ef2c0633a54a5083c6c0e2100fe3a6fb695cae8c3218dbcf6a0862fb5adde30269c0d5885afa2ea0bf8a31bef3eed6ad1b42f04587611dc9c
+  metadata.gz: fe0f6286ba31d60bd4db9d2597b9f30bed32cb9b4e1a113d9fcb46c906b51e8e3b8e9eab93ce7edfcd39486b8c5171724f8d1079e94a4d20d6e486b1db76ffc9
+  data.tar.gz: 43264b5a7a02d0d033fa3b25a97e59c3273ed473133107431639747a33be0922290911a29abd07b1d9050915c3df46b3f9dff54019cabe57f342844b75d382c2

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.0.4] - 2026-01-06
+
+### Fixed
+- Fixed API URL path construction (removed leading slashes causing requests to bypass /api/v4 path)
+- Fixed MCP response serialization (workaround for MCP gem bug where Content objects aren't converted to hashes)
+
 ## [1.0.3] - 2026-01-06
 
 ### Fixed

data/README.md

@@ -142,12 +142,82 @@ Parameters:
 bundle exec rspec
 ```
 
-### Building the Gem
+### Building and Installing from Source
 
 ```bash
+# Build the gem
 gem build airbrake_mcp.gemspec
+
+# Install locally
+gem install ./airbrake_mcp-*.gem --no-document
+
+# If using rbenv, rehash to update shims
+rbenv rehash
+```
+
+### Updating an Installed Gem
+
+When updating the gem after code changes:
+
+```bash
+# 1. Remove ALL old versions
+gem uninstall airbrake_mcp --all --executables --ignore-dependencies
+
+# 2. Remove old gem files
+rm -f *.gem
+
+# 3. Build fresh gem
+gem build airbrake_mcp.gemspec
+
+# 4. Install with force flag
+gem install ./airbrake_mcp-*.gem --no-document --force
+
+# 5. Rehash rbenv shims
+rbenv rehash
+
+# 6. Verify installation
+gem which airbrake_mcp
 ```
 
+## Troubleshooting
+
+### "command not found" after installation
+
+If you see `rbenv: airbrake_mcp: command not found`, the gem was installed for a different Ruby version.
+
+```bash
+# Check which Ruby versions have the gem
+rbenv versions  # shows available versions
+gem list airbrake_mcp  # shows if installed for current Ruby
+
+# Install for the correct Ruby version
+RBENV_VERSION=3.4.4 gem install ./airbrake_mcp-*.gem --no-document
+rbenv rehash
+```
+
+### MCP fails to connect after gem update
+
+1. Ensure the gem is completely uninstalled before reinstalling:
+   ```bash
+   gem uninstall airbrake_mcp --all --executables --ignore-dependencies
+   ```
+
+2. Verify the new code is in the built gem:
+   ```bash
+   gem unpack airbrake_mcp-*.gem --target=/tmp/check
+   cat /tmp/check/airbrake_mcp-*/lib/airbrake_mcp/client.rb
+   rm -rf /tmp/check
+   ```
+
+3. After installation, verify the installed code:
+   ```bash
+   cat $(dirname $(gem which airbrake_mcp))/airbrake_mcp/client.rb
+   ```
+
+### Large Error Group IDs
+
+Airbrake uses very large integers for error group IDs (e.g., `4235892606830408977`). These IDs are passed as strings to avoid JavaScript precision loss issues. When using tools like `get_error` or `list_notices`, provide the `group_id` exactly as shown in `list_errors` output.
+
 ## License
 
 MIT

data/lib/airbrake_mcp/client.rb

@@ -15,36 +15,36 @@ module AirbrakeMcp
     attr_reader :project_id
 
     def projects
-      get('/projects')['projects']
+      get('projects')['projects']
     end
 
     def groups(project_id: @project_id, page: 1, limit: 20)
-      get("/projects/#{project_id}/groups", { page: page, limit: limit })
+      get("projects/#{project_id}/groups", { page: page, limit: limit })
     end
 
     def group(group_id, project_id: @project_id)
-      get("/projects/#{project_id}/groups/#{group_id}")
+      get("projects/#{project_id}/groups/#{group_id}")['group']
     end
 
     def notices(group_id, project_id: @project_id, page: 1, limit: 10)
-      get("/projects/#{project_id}/groups/#{group_id}/notices", { page: page, limit: limit })
+      get("projects/#{project_id}/groups/#{group_id}/notices", { page: page, limit: limit })
     end
 
     # Write operations
     def resolve_group(group_id, project_id: @project_id)
-      put("/projects/#{project_id}/groups/#{group_id}/resolved")
+      put("projects/#{project_id}/groups/#{group_id}/resolved")
     end
 
     def unresolve_group(group_id, project_id: @project_id)
-      put("/projects/#{project_id}/groups/#{group_id}/unresolved")
+      put("projects/#{project_id}/groups/#{group_id}/unresolved")
     end
 
     def mute_group(group_id, project_id: @project_id)
-      put("/projects/#{project_id}/groups/#{group_id}/muted")
+      put("projects/#{project_id}/groups/#{group_id}/muted")
     end
 
     def unmute_group(group_id, project_id: @project_id)
-      put("/projects/#{project_id}/groups/#{group_id}/unmuted")
+      put("projects/#{project_id}/groups/#{group_id}/unmuted")
     end
 
     private

data/lib/airbrake_mcp/formatters.rb

@@ -29,7 +29,7 @@ module AirbrakeMcp
         muted = group['muted'] ? ' (muted)' : ''
         error = group['errors']&.first || {}
 
-        output += "#{status}#{muted} ##{group['id']}\n"
+        output += "#{status}#{muted} id:#{group['id']}\n"
         output += "  Type: #{error['type']}\n"
         output += "  Message: #{truncate(error['message'], 100)}\n"
         output += "  Count: #{group['noticeCount']} occurrences\n"

data/lib/airbrake_mcp/response_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AirbrakeMcp
+  module ResponseHelper
+    # Workaround for MCP gem bug where Content objects aren't converted to hashes
+    # in Response#to_h. This creates responses with pre-converted content.
+    def self.text_response(text, error: false)
+      MCP::Tool::Response.new([{ type: "text", text: text }], error: error)
+    end
+  end
+end

data/lib/airbrake_mcp/tools/get_error.rb

@@ -8,7 +8,7 @@ module AirbrakeMcp
 
       input_schema(
         properties: {
-          group_id: { type: "integer", description: "Error group ID" },
+          group_id: { type: "string", description: "Error group ID" },
           project_id: { type: "integer", description: "Project ID (uses default if not specified)" }
         },
         required: ["group_id"]
@@ -19,24 +19,16 @@ module AirbrakeMcp
         pid = project_id || client.project_id
 
         unless pid
-          return MCP::Tool::Response.new([
-            MCP::Content::Text.new("Error: No project_id specified and no default configured")
-          ], error: true)
+          return ResponseHelper.text_response("Error: No project_id specified and no default configured", error: true)
         end
 
         group = client.group(group_id, project_id: pid)
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new(Formatters.format_group_detail(group))
-        ])
+        ResponseHelper.text_response(Formatters.format_group_detail(group))
       rescue Client::NotFoundError
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: Error group #{group_id} not found")
-        ], error: true)
+        ResponseHelper.text_response("Error: Error group #{group_id} not found", error: true)
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/tools/list_errors.rb

@@ -21,9 +21,7 @@ module AirbrakeMcp
         pid = project_id || client.project_id
 
         unless pid
-          return MCP::Tool::Response.new([
-            MCP::Content::Text.new("Error: No project_id specified and no default configured")
-          ], error: true)
+          return ResponseHelper.text_response("Error: No project_id specified and no default configured", error: true)
         end
 
         result = client.groups(project_id: pid, page: page, limit: limit)
@@ -33,13 +31,9 @@ module AirbrakeMcp
           result['groups'] = result['groups'].select { |g| g['resolved'] == resolved }
         end
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new(Formatters.format_groups(result))
-        ])
+        ResponseHelper.text_response(Formatters.format_groups(result))
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/tools/list_notices.rb

@@ -8,7 +8,7 @@ module AirbrakeMcp
 
       input_schema(
         properties: {
-          group_id: { type: "integer", description: "Error group ID" },
+          group_id: { type: "string", description: "Error group ID" },
           project_id: { type: "integer", description: "Project ID (uses default if not specified)" },
           page: { type: "integer", description: "Page number (default: 1)" },
           limit: { type: "integer", description: "Results per page (default: 10)" }
@@ -21,24 +21,16 @@ module AirbrakeMcp
         pid = project_id || client.project_id
 
         unless pid
-          return MCP::Tool::Response.new([
-            MCP::Content::Text.new("Error: No project_id specified and no default configured")
-          ], error: true)
+          return ResponseHelper.text_response("Error: No project_id specified and no default configured", error: true)
         end
 
         result = client.notices(group_id, project_id: pid, page: page, limit: limit)
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new(Formatters.format_notices(result))
-        ])
+        ResponseHelper.text_response(Formatters.format_notices(result))
       rescue Client::NotFoundError
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: Error group #{group_id} not found")
-        ], error: true)
+        ResponseHelper.text_response("Error: Error group #{group_id} not found", error: true)
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/tools/list_projects.rb

@@ -10,13 +10,9 @@ module AirbrakeMcp
         client = server_context[:client]
         projects = client.projects
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new(Formatters.format_projects(projects))
-        ])
+        ResponseHelper.text_response(Formatters.format_projects(projects))
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/tools/mute_error.rb

@@ -8,7 +8,7 @@ module AirbrakeMcp
 
       input_schema(
         properties: {
-          group_id: { type: "integer", description: "Error group ID" },
+          group_id: { type: "string", description: "Error group ID" },
           project_id: { type: "integer", description: "Project ID (uses default if not specified)" },
           mute: { type: "boolean", description: "true to mute, false to unmute (default: true)" }
         },
@@ -20,9 +20,7 @@ module AirbrakeMcp
         pid = project_id || client.project_id
 
         unless pid
-          return MCP::Tool::Response.new([
-            MCP::Content::Text.new("Error: No project_id specified and no default configured")
-          ], error: true)
+          return ResponseHelper.text_response("Error: No project_id specified and no default configured", error: true)
         end
 
         if mute
@@ -33,17 +31,11 @@ module AirbrakeMcp
           action = "unmuted"
         end
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error group ##{group_id} #{action}")
-        ])
+        ResponseHelper.text_response("Error group ##{group_id} #{action}")
       rescue Client::NotFoundError
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: Error group #{group_id} not found")
-        ], error: true)
+        ResponseHelper.text_response("Error: Error group #{group_id} not found", error: true)
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/tools/resolve_error.rb

@@ -8,7 +8,7 @@ module AirbrakeMcp
 
       input_schema(
         properties: {
-          group_id: { type: "integer", description: "Error group ID" },
+          group_id: { type: "string", description: "Error group ID" },
           project_id: { type: "integer", description: "Project ID (uses default if not specified)" },
           resolved: { type: "boolean", description: "true to resolve, false to unresolve (default: true)" }
         },
@@ -20,9 +20,7 @@ module AirbrakeMcp
         pid = project_id || client.project_id
 
         unless pid
-          return MCP::Tool::Response.new([
-            MCP::Content::Text.new("Error: No project_id specified and no default configured")
-          ], error: true)
+          return ResponseHelper.text_response("Error: No project_id specified and no default configured", error: true)
         end
 
         if resolved
@@ -33,17 +31,11 @@ module AirbrakeMcp
           action = "unresolved"
         end
 
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error group ##{group_id} marked as #{action}")
-        ])
+        ResponseHelper.text_response("Error group ##{group_id} marked as #{action}")
       rescue Client::NotFoundError
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: Error group #{group_id} not found")
-        ], error: true)
+        ResponseHelper.text_response("Error: Error group #{group_id} not found", error: true)
       rescue Client::ApiError => e
-        MCP::Tool::Response.new([
-          MCP::Content::Text.new("Error: #{e.message}")
-        ], error: true)
+        ResponseHelper.text_response("Error: #{e.message}", error: true)
       end
     end
   end

data/lib/airbrake_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AirbrakeMcp
-  VERSION = '1.0.3'
+  VERSION = '1.0.5'
 end

data/lib/airbrake_mcp.rb

@@ -5,6 +5,7 @@ require 'mcp'
 require_relative 'airbrake_mcp/version'
 require_relative 'airbrake_mcp/client'
 require_relative 'airbrake_mcp/formatters'
+require_relative 'airbrake_mcp/response_helper'
 require_relative 'airbrake_mcp/tools/list_projects'
 require_relative 'airbrake_mcp/tools/list_errors'
 require_relative 'airbrake_mcp/tools/get_error'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airbrake_mcp
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.5
 platform: ruby
 authors:
 - httplab
@@ -95,6 +95,7 @@ files:
 - lib/airbrake_mcp.rb
 - lib/airbrake_mcp/client.rb
 - lib/airbrake_mcp/formatters.rb
+- lib/airbrake_mcp/response_helper.rb
 - lib/airbrake_mcp/tools/get_error.rb
 - lib/airbrake_mcp/tools/list_errors.rb
 - lib/airbrake_mcp/tools/list_notices.rb