The project is in a healthy, maintained state
Exposes the ask-ruby-harness tools (QueryDatabase, ReadModel, ReadLog, RunCommand, SchemaGraph, RunTests) as MCP tools for any Ruby project. Coding agents like Claude Code, Cursor, or any MCP-compatible client can connect to query the database, inspect models, read logs, run commands, and run tests with structured results.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 5.25
~> 3.1
~> 13.0

Runtime

>= 0.4.5
 Project Readme

Ask Ruby Harness MCP

MCP server exposing the ask-ruby-harness tools over the Model Context Protocol — for any Ruby project.

Tool What it does
query_database Read-only SQL (non-SELECT rejected; SELECT-only in production)
read_model Inspect an ActiveRecord model's columns, associations, validations
read_log Read log files with filtering and rotation support
run_command Run shell commands, gated by permission rules
schema_graph Full schema introspection: models, tables, columns, associations
run_tests Structured test results with failure reruns (rails test / rspec / rake test)

The server serves the project in its working directory — point your MCP client at it from any Ruby project root (works in monorepos: run_tests with a file: inside a subproject runs that project's suite).

Usage

ask-ruby-harness-mcp

Register it as a stdio MCP server in your client (e.g. ~/.zcode/cli/config.json or a workspace .zcode/config.json):

{
  "mcp": {
    "servers": {
      "ask-ruby-harness-mcp": {
        "type": "stdio",
        "command": "ask-ruby-harness-mcp",
        "cwd": "/path/to/your/ruby/project"
      }
    }
  }
}

Development

bundle install
bundle exec rake test

License

MIT — see LICENSE.