debug-mcp 0.1.2

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