girb-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +3 -0
  3. data/CHANGELOG.md +16 -0
  4. data/LICENSE +21 -0
  5. data/README.ja.md +349 -0
  6. data/README.md +351 -0
  7. data/examples/01_simple_bug.rb +43 -0
  8. data/examples/02_data_pipeline.rb +93 -0
  9. data/examples/03_recursion.rb +96 -0
  10. data/examples/RAILS_SCENARIOS.md +350 -0
  11. data/examples/SCENARIOS.md +142 -0
  12. data/examples/rails_test_app/setup.sh +428 -0
  13. data/examples/rails_test_app/testapp/.dockerignore +10 -0
  14. data/examples/rails_test_app/testapp/.ruby-version +1 -0
  15. data/examples/rails_test_app/testapp/Dockerfile +23 -0
  16. data/examples/rails_test_app/testapp/Gemfile +17 -0
  17. data/examples/rails_test_app/testapp/README.md +65 -0
  18. data/examples/rails_test_app/testapp/Rakefile +6 -0
  19. data/examples/rails_test_app/testapp/app/assets/images/.keep +0 -0
  20. data/examples/rails_test_app/testapp/app/assets/stylesheets/application.css +1 -0
  21. data/examples/rails_test_app/testapp/app/controllers/application_controller.rb +4 -0
  22. data/examples/rails_test_app/testapp/app/controllers/concerns/.keep +0 -0
  23. data/examples/rails_test_app/testapp/app/controllers/dashboard_controller.rb +38 -0
  24. data/examples/rails_test_app/testapp/app/controllers/health_controller.rb +11 -0
  25. data/examples/rails_test_app/testapp/app/controllers/orders_controller.rb +100 -0
  26. data/examples/rails_test_app/testapp/app/controllers/posts_controller.rb +82 -0
  27. data/examples/rails_test_app/testapp/app/controllers/sessions_controller.rb +25 -0
  28. data/examples/rails_test_app/testapp/app/controllers/users_controller.rb +44 -0
  29. data/examples/rails_test_app/testapp/app/helpers/application_helper.rb +2 -0
  30. data/examples/rails_test_app/testapp/app/models/application_record.rb +3 -0
  31. data/examples/rails_test_app/testapp/app/models/comment.rb +8 -0
  32. data/examples/rails_test_app/testapp/app/models/concerns/.keep +0 -0
  33. data/examples/rails_test_app/testapp/app/models/order.rb +56 -0
  34. data/examples/rails_test_app/testapp/app/models/order_item.rb +16 -0
  35. data/examples/rails_test_app/testapp/app/models/post.rb +29 -0
  36. data/examples/rails_test_app/testapp/app/models/user.rb +34 -0
  37. data/examples/rails_test_app/testapp/app/services/order_report_service.rb +40 -0
  38. data/examples/rails_test_app/testapp/app/views/layouts/application.html.erb +28 -0
  39. data/examples/rails_test_app/testapp/app/views/pwa/manifest.json.erb +22 -0
  40. data/examples/rails_test_app/testapp/app/views/pwa/service-worker.js +26 -0
  41. data/examples/rails_test_app/testapp/bin/ci +6 -0
  42. data/examples/rails_test_app/testapp/bin/dev +2 -0
  43. data/examples/rails_test_app/testapp/bin/rails +4 -0
  44. data/examples/rails_test_app/testapp/bin/rake +4 -0
  45. data/examples/rails_test_app/testapp/bin/setup +35 -0
  46. data/examples/rails_test_app/testapp/config/application.rb +42 -0
  47. data/examples/rails_test_app/testapp/config/boot.rb +3 -0
  48. data/examples/rails_test_app/testapp/config/ci.rb +14 -0
  49. data/examples/rails_test_app/testapp/config/database.yml +32 -0
  50. data/examples/rails_test_app/testapp/config/environment.rb +5 -0
  51. data/examples/rails_test_app/testapp/config/environments/development.rb +54 -0
  52. data/examples/rails_test_app/testapp/config/environments/production.rb +67 -0
  53. data/examples/rails_test_app/testapp/config/environments/test.rb +42 -0
  54. data/examples/rails_test_app/testapp/config/initializers/content_security_policy.rb +29 -0
  55. data/examples/rails_test_app/testapp/config/initializers/filter_parameter_logging.rb +8 -0
  56. data/examples/rails_test_app/testapp/config/initializers/inflections.rb +16 -0
  57. data/examples/rails_test_app/testapp/config/locales/en.yml +31 -0
  58. data/examples/rails_test_app/testapp/config/puma.rb +39 -0
  59. data/examples/rails_test_app/testapp/config/routes.rb +34 -0
  60. data/examples/rails_test_app/testapp/config.ru +6 -0
  61. data/examples/rails_test_app/testapp/db/migrate/20260216002916_create_users.rb +12 -0
  62. data/examples/rails_test_app/testapp/db/migrate/20260216002919_create_posts.rb +13 -0
  63. data/examples/rails_test_app/testapp/db/migrate/20260216002922_create_comments.rb +11 -0
  64. data/examples/rails_test_app/testapp/db/migrate/20260222000001_create_orders.rb +14 -0
  65. data/examples/rails_test_app/testapp/db/migrate/20260222000002_create_order_items.rb +13 -0
  66. data/examples/rails_test_app/testapp/db/schema.rb +71 -0
  67. data/examples/rails_test_app/testapp/db/seeds.rb +85 -0
  68. data/examples/rails_test_app/testapp/docker-compose.yml +21 -0
  69. data/examples/rails_test_app/testapp/docker-entrypoint.sh +10 -0
  70. data/examples/rails_test_app/testapp/lib/tasks/.keep +0 -0
  71. data/examples/rails_test_app/testapp/log/.keep +0 -0
  72. data/examples/rails_test_app/testapp/public/400.html +135 -0
  73. data/examples/rails_test_app/testapp/public/404.html +135 -0
  74. data/examples/rails_test_app/testapp/public/406-unsupported-browser.html +135 -0
  75. data/examples/rails_test_app/testapp/public/422.html +135 -0
  76. data/examples/rails_test_app/testapp/public/500.html +135 -0
  77. data/examples/rails_test_app/testapp/public/icon.png +0 -0
  78. data/examples/rails_test_app/testapp/public/icon.svg +3 -0
  79. data/examples/rails_test_app/testapp/public/robots.txt +1 -0
  80. data/examples/rails_test_app/testapp/script/.keep +0 -0
  81. data/examples/rails_test_app/testapp/storage/.keep +0 -0
  82. data/examples/rails_test_app/testapp/tmp/.keep +0 -0
  83. data/examples/rails_test_app/testapp/tmp/pids/.keep +0 -0
  84. data/examples/rails_test_app/testapp/tmp/storage/.keep +0 -0
  85. data/examples/rails_test_app/testapp/vendor/.keep +0 -0
  86. data/exe/girb-mcp +39 -0
  87. data/exe/girb-rails +127 -0
  88. data/lib/girb_mcp/client_cleanup.rb +102 -0
  89. data/lib/girb_mcp/code_safety_analyzer.rb +124 -0
  90. data/lib/girb_mcp/debug_client.rb +1109 -0
  91. data/lib/girb_mcp/exit_message_builder.rb +112 -0
  92. data/lib/girb_mcp/pending_http_helper.rb +25 -0
  93. data/lib/girb_mcp/rails_helper.rb +155 -0
  94. data/lib/girb_mcp/server.rb +363 -0
  95. data/lib/girb_mcp/session_manager.rb +436 -0
  96. data/lib/girb_mcp/stop_event_annotator.rb +152 -0
  97. data/lib/girb_mcp/tcp_session_discovery.rb +226 -0
  98. data/lib/girb_mcp/tools/connect.rb +668 -0
  99. data/lib/girb_mcp/tools/continue_execution.rb +161 -0
  100. data/lib/girb_mcp/tools/disconnect.rb +168 -0
  101. data/lib/girb_mcp/tools/evaluate_code.rb +354 -0
  102. data/lib/girb_mcp/tools/finish.rb +84 -0
  103. data/lib/girb_mcp/tools/get_context.rb +217 -0
  104. data/lib/girb_mcp/tools/get_source.rb +193 -0
  105. data/lib/girb_mcp/tools/inspect_object.rb +107 -0
  106. data/lib/girb_mcp/tools/list_debug_sessions.rb +60 -0
  107. data/lib/girb_mcp/tools/list_files.rb +189 -0
  108. data/lib/girb_mcp/tools/list_paused_sessions.rb +108 -0
  109. data/lib/girb_mcp/tools/next.rb +70 -0
  110. data/lib/girb_mcp/tools/rails_info.rb +200 -0
  111. data/lib/girb_mcp/tools/rails_model.rb +362 -0
  112. data/lib/girb_mcp/tools/rails_routes.rb +186 -0
  113. data/lib/girb_mcp/tools/read_file.rb +214 -0
  114. data/lib/girb_mcp/tools/remove_breakpoint.rb +173 -0
  115. data/lib/girb_mcp/tools/run_debug_command.rb +55 -0
  116. data/lib/girb_mcp/tools/run_script.rb +293 -0
  117. data/lib/girb_mcp/tools/set_breakpoint.rb +206 -0
  118. data/lib/girb_mcp/tools/step.rb +67 -0
  119. data/lib/girb_mcp/tools/trigger_request.rb +515 -0
  120. data/lib/girb_mcp/version.rb +5 -0
  121. data/lib/girb_mcp.rb +40 -0
  122. metadata +237 -0
metadata ADDED
@@ -0,0 +1,237 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: girb-mcp
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - rira100000000
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: debug
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.0'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.0'
26
+ - !ruby/object:Gem::Dependency
27
+ name: mcp
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '0.7'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '0.7'
40
+ - !ruby/object:Gem::Dependency
41
+ name: webrick
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '1.9'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '1.9'
54
+ - !ruby/object:Gem::Dependency
55
+ name: rake
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '13.0'
61
+ type: :development
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '13.0'
68
+ - !ruby/object:Gem::Dependency
69
+ name: rspec
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: '3.0'
75
+ type: :development
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: '3.0'
82
+ description: An MCP (Model Context Protocol) server that provides LLM agents with
83
+ access to runtime context of executing Ruby processes. Connect to debug sessions,
84
+ evaluate code, inspect objects, and control execution flow via MCP tools.
85
+ email:
86
+ - 101010hayakawa@gmail.com
87
+ executables:
88
+ - girb-mcp
89
+ - girb-rails
90
+ extensions: []
91
+ extra_rdoc_files: []
92
+ files:
93
+ - ".rspec"
94
+ - CHANGELOG.md
95
+ - LICENSE
96
+ - README.ja.md
97
+ - README.md
98
+ - examples/01_simple_bug.rb
99
+ - examples/02_data_pipeline.rb
100
+ - examples/03_recursion.rb
101
+ - examples/RAILS_SCENARIOS.md
102
+ - examples/SCENARIOS.md
103
+ - examples/rails_test_app/setup.sh
104
+ - examples/rails_test_app/testapp/.dockerignore
105
+ - examples/rails_test_app/testapp/.ruby-version
106
+ - examples/rails_test_app/testapp/Dockerfile
107
+ - examples/rails_test_app/testapp/Gemfile
108
+ - examples/rails_test_app/testapp/README.md
109
+ - examples/rails_test_app/testapp/Rakefile
110
+ - examples/rails_test_app/testapp/app/assets/images/.keep
111
+ - examples/rails_test_app/testapp/app/assets/stylesheets/application.css
112
+ - examples/rails_test_app/testapp/app/controllers/application_controller.rb
113
+ - examples/rails_test_app/testapp/app/controllers/concerns/.keep
114
+ - examples/rails_test_app/testapp/app/controllers/dashboard_controller.rb
115
+ - examples/rails_test_app/testapp/app/controllers/health_controller.rb
116
+ - examples/rails_test_app/testapp/app/controllers/orders_controller.rb
117
+ - examples/rails_test_app/testapp/app/controllers/posts_controller.rb
118
+ - examples/rails_test_app/testapp/app/controllers/sessions_controller.rb
119
+ - examples/rails_test_app/testapp/app/controllers/users_controller.rb
120
+ - examples/rails_test_app/testapp/app/helpers/application_helper.rb
121
+ - examples/rails_test_app/testapp/app/models/application_record.rb
122
+ - examples/rails_test_app/testapp/app/models/comment.rb
123
+ - examples/rails_test_app/testapp/app/models/concerns/.keep
124
+ - examples/rails_test_app/testapp/app/models/order.rb
125
+ - examples/rails_test_app/testapp/app/models/order_item.rb
126
+ - examples/rails_test_app/testapp/app/models/post.rb
127
+ - examples/rails_test_app/testapp/app/models/user.rb
128
+ - examples/rails_test_app/testapp/app/services/order_report_service.rb
129
+ - examples/rails_test_app/testapp/app/views/layouts/application.html.erb
130
+ - examples/rails_test_app/testapp/app/views/pwa/manifest.json.erb
131
+ - examples/rails_test_app/testapp/app/views/pwa/service-worker.js
132
+ - examples/rails_test_app/testapp/bin/ci
133
+ - examples/rails_test_app/testapp/bin/dev
134
+ - examples/rails_test_app/testapp/bin/rails
135
+ - examples/rails_test_app/testapp/bin/rake
136
+ - examples/rails_test_app/testapp/bin/setup
137
+ - examples/rails_test_app/testapp/config.ru
138
+ - examples/rails_test_app/testapp/config/application.rb
139
+ - examples/rails_test_app/testapp/config/boot.rb
140
+ - examples/rails_test_app/testapp/config/ci.rb
141
+ - examples/rails_test_app/testapp/config/database.yml
142
+ - examples/rails_test_app/testapp/config/environment.rb
143
+ - examples/rails_test_app/testapp/config/environments/development.rb
144
+ - examples/rails_test_app/testapp/config/environments/production.rb
145
+ - examples/rails_test_app/testapp/config/environments/test.rb
146
+ - examples/rails_test_app/testapp/config/initializers/content_security_policy.rb
147
+ - examples/rails_test_app/testapp/config/initializers/filter_parameter_logging.rb
148
+ - examples/rails_test_app/testapp/config/initializers/inflections.rb
149
+ - examples/rails_test_app/testapp/config/locales/en.yml
150
+ - examples/rails_test_app/testapp/config/puma.rb
151
+ - examples/rails_test_app/testapp/config/routes.rb
152
+ - examples/rails_test_app/testapp/db/migrate/20260216002916_create_users.rb
153
+ - examples/rails_test_app/testapp/db/migrate/20260216002919_create_posts.rb
154
+ - examples/rails_test_app/testapp/db/migrate/20260216002922_create_comments.rb
155
+ - examples/rails_test_app/testapp/db/migrate/20260222000001_create_orders.rb
156
+ - examples/rails_test_app/testapp/db/migrate/20260222000002_create_order_items.rb
157
+ - examples/rails_test_app/testapp/db/schema.rb
158
+ - examples/rails_test_app/testapp/db/seeds.rb
159
+ - examples/rails_test_app/testapp/docker-compose.yml
160
+ - examples/rails_test_app/testapp/docker-entrypoint.sh
161
+ - examples/rails_test_app/testapp/lib/tasks/.keep
162
+ - examples/rails_test_app/testapp/log/.keep
163
+ - examples/rails_test_app/testapp/public/400.html
164
+ - examples/rails_test_app/testapp/public/404.html
165
+ - examples/rails_test_app/testapp/public/406-unsupported-browser.html
166
+ - examples/rails_test_app/testapp/public/422.html
167
+ - examples/rails_test_app/testapp/public/500.html
168
+ - examples/rails_test_app/testapp/public/icon.png
169
+ - examples/rails_test_app/testapp/public/icon.svg
170
+ - examples/rails_test_app/testapp/public/robots.txt
171
+ - examples/rails_test_app/testapp/script/.keep
172
+ - examples/rails_test_app/testapp/storage/.keep
173
+ - examples/rails_test_app/testapp/tmp/.keep
174
+ - examples/rails_test_app/testapp/tmp/pids/.keep
175
+ - examples/rails_test_app/testapp/tmp/storage/.keep
176
+ - examples/rails_test_app/testapp/vendor/.keep
177
+ - exe/girb-mcp
178
+ - exe/girb-rails
179
+ - lib/girb_mcp.rb
180
+ - lib/girb_mcp/client_cleanup.rb
181
+ - lib/girb_mcp/code_safety_analyzer.rb
182
+ - lib/girb_mcp/debug_client.rb
183
+ - lib/girb_mcp/exit_message_builder.rb
184
+ - lib/girb_mcp/pending_http_helper.rb
185
+ - lib/girb_mcp/rails_helper.rb
186
+ - lib/girb_mcp/server.rb
187
+ - lib/girb_mcp/session_manager.rb
188
+ - lib/girb_mcp/stop_event_annotator.rb
189
+ - lib/girb_mcp/tcp_session_discovery.rb
190
+ - lib/girb_mcp/tools/connect.rb
191
+ - lib/girb_mcp/tools/continue_execution.rb
192
+ - lib/girb_mcp/tools/disconnect.rb
193
+ - lib/girb_mcp/tools/evaluate_code.rb
194
+ - lib/girb_mcp/tools/finish.rb
195
+ - lib/girb_mcp/tools/get_context.rb
196
+ - lib/girb_mcp/tools/get_source.rb
197
+ - lib/girb_mcp/tools/inspect_object.rb
198
+ - lib/girb_mcp/tools/list_debug_sessions.rb
199
+ - lib/girb_mcp/tools/list_files.rb
200
+ - lib/girb_mcp/tools/list_paused_sessions.rb
201
+ - lib/girb_mcp/tools/next.rb
202
+ - lib/girb_mcp/tools/rails_info.rb
203
+ - lib/girb_mcp/tools/rails_model.rb
204
+ - lib/girb_mcp/tools/rails_routes.rb
205
+ - lib/girb_mcp/tools/read_file.rb
206
+ - lib/girb_mcp/tools/remove_breakpoint.rb
207
+ - lib/girb_mcp/tools/run_debug_command.rb
208
+ - lib/girb_mcp/tools/run_script.rb
209
+ - lib/girb_mcp/tools/set_breakpoint.rb
210
+ - lib/girb_mcp/tools/step.rb
211
+ - lib/girb_mcp/tools/trigger_request.rb
212
+ - lib/girb_mcp/version.rb
213
+ homepage: https://github.com/rira100000000/girb-mcp
214
+ licenses:
215
+ - MIT
216
+ metadata:
217
+ homepage_uri: https://github.com/rira100000000/girb-mcp
218
+ source_code_uri: https://github.com/rira100000000/girb-mcp
219
+ changelog_uri: https://github.com/rira100000000/girb-mcp/blob/main/CHANGELOG.md
220
+ rdoc_options: []
221
+ require_paths:
222
+ - lib
223
+ required_ruby_version: !ruby/object:Gem::Requirement
224
+ requirements:
225
+ - - ">="
226
+ - !ruby/object:Gem::Version
227
+ version: 3.2.0
228
+ required_rubygems_version: !ruby/object:Gem::Requirement
229
+ requirements:
230
+ - - ">="
231
+ - !ruby/object:Gem::Version
232
+ version: '0'
233
+ requirements: []
234
+ rubygems_version: 3.7.2
235
+ specification_version: 4
236
+ summary: MCP server for Ruby runtime debugging
237
+ test_files: []