studio 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0ac4b3ac6f6fbeebc3dbf0aafcc521035ee7ae5be4333819a84fd43f40c5c998
+  data.tar.gz: 31f702dc105efcb28df1070f2b22b46c2b88d914989ab2599b575d929294ab6d
+SHA512:
+  metadata.gz: 16ca24292c16c4a6a9a6412e205305eb0f051ee236c4603570666638115984dfcee13b3cc7c9e0dbc2e6fef6132c2105ee57502e7bb4446d7a4a94143954fc6b
+  data.tar.gz: 1302ac921460a521c225296fc08bc36e4d764dd57990a1e75bb438c36501ad46eed26375aca4f7ff34a9467083175e8ab1e33b25eba4cb1703174c6fd5a16b5a

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,46 @@
+plugins:
+  - rubocop-performance
+  - rubocop-rspec
+  - rubocop-rake
+
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: enable
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+    - "*.gemspec"
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Exclude:
+    - "spec/**/*"
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - "spec/**/*"
+
+Metrics/PerceivedComplexity:
+  Exclude:
+    - "spec/**/*"
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-06-11
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Martin Emde
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,140 @@
+# Studio
+
+Make any CLI into a single tool MCP server.
+
+> Bright Studio Apt – No Walls, No Rules – 800/mo OBO.
+>
+> Wired and wild. No questions, no backups. rm -rf compatible. Cash only. Basement-ish. BYO everything. Just enough, nothing more.
+>
+> Text 404 to /dev/null for more details!
+
+## Install
+
+```sh
+$ gem install studio
+```
+
+### Claude Code
+
+```sh
+#                <serv-name> studio <cmd> <arguments or blueprints>
+$ claude mcp add echo-server studio echo "{{text#What do you want to say?}}"
+```
+
+```sh
+$ claude mcp add git-log studio git log --one-line -n 20 --ref "{{branch}}"
+```
+
+### Cursor
+
+Make sure `studio` is installed, then
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=echo&config=eyJjb21tYW5kIjoic3R1ZGlvIHt7dGV4dCNXaGF0IGRvIHlvdSB3YW50IHRvIHNheT99fSJ9)
+
+Add to your `.cursor/mcp.json` manually:
+
+```json
+{
+  "mcpServers": {
+    "echo": {
+      "command": "studio",
+      "args": ["echo", "{{text#What do you want to say?}}"]
+    },
+    "rails": {
+      "command": "studio",
+      "args": ["rails", "generate", "{{generator # A valid rails generator like scaffold, model}}"]
+    }
+  }
+}
+```
+
+### VSCode
+
+_Pay attention, one says `stdio`, the other says `studio`! (uh oh, what have I done?)_
+
+```json
+    "mcp": {
+        "servers": {
+            "echo": {
+                "type": "stdio",
+                "command": "studio",
+                "args": ["echo", "{{text#What do you want to say?}}"]
+            }
+        }
+    }
+```
+
+### Do you speak MCP?
+
+```bash
+$ studio echo
+```
+
+Now you're speaking to the mcp server, so say something smart.
+
+**ping**
+
+```json
+{"jsonrpc":"2.0","id":"1","method":"ping"}
+```
+
+or not... just play ping pong if you wish.
+
+ **initialize**
+
+```json
+{"jsonrpc": "2.0","id": "2","method": "initialize","params": {"protocolVersion": "2024-11-05","capabilities": {},"clientInfo": {"name": "test-client","version": "1.0.0"}}}
+```
+
+that's better...
+
+ **list tools**
+
+```json
+{"jsonrpc":"2.0","id":"3","method":"tools/list"}
+```
+
+Oh look, a hammer...
+
+**use tool**
+
+```json
+{"jsonrpc": "2.0","id": "4","method": "tools/call","params": {"name": "echo","arguments": {"args": ["hello", "world"]}}}
+```
+
+### Blueprints
+
+Use blueprints (templates) to keep your studio tidy.
+
+```bash
+studio rails generate "{{generator # A valid rails generator like scaffold, model}}"
+```
+
+This creates an Studio server with one argument: `generator`.
+Everything after the `#` will be used as the description of the argument.
+
+Blueprints use the format: `{{name # description}}`.
+
+- `name`: The argument name that will be exposed in the MCP tool schema
+- `description`: A description of what the argument should contain. May contain spaces.
+
+This is a simple studio, not one of those fancy 1 bedroom flats. Blueprint types, flags, arrays? The landlord will upgrade the place for free eventually, right? Right?
+
+## Development
+
+**Keys to the City**. Run `bin/setup` to move in. Run `bin/rake` for a quick inspection.
+
+Bump `version.rb`, tag it `vX.Y.Z`, push to GitHub. Trusted publishing will be happy to receive your rent check.
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, tag the release vX.Y.Z, then push the tag to github. Trusted publishing will do the rest.
+
+## Home Is Where You Make It
+
+This is your studio too. Bugs, features, ideas? Swing by the repo:
+🏠 https://github.com/martinemde/studio
+
+## Lease Terms: MIT
+
+Move in under the standard terms, no fine print. Full text here: [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/exe/studio

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "studio"
+
+Studio.serve(ARGV)

data/lib/studio/blueprint.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+require "shellwords"
+
+module Studio
+  class Blueprint # rubocop:todo Style/Documentation
+    attr_reader :argv, :base_command, :blueprint_args
+
+    def self.argv(argv)
+      new(argv)
+    end
+
+    def initialize(argv)
+      @argv = argv.dup
+      @base_command = @argv.shift
+      @blueprint_args = parse_blueprint_args(@argv)
+    end
+
+    # Execute the command with provided arguments
+    def execute(args = [])
+      full_command = build_command(args)
+
+      # Spawn the process and capture output
+      stdout, stderr, status = Open3.capture3(*full_command)
+
+      {
+        stdout: stdout,
+        stderr: stderr,
+        exit_code: status.exitstatus,
+        success: status.success?
+      }
+    rescue StandardError => e
+      {
+        stdout: "",
+        stderr: "Studio error: #{e.message}",
+        exit_code: 1,
+        success: false
+      }
+    end
+
+    # Get the tool name for MCP
+    def tool_name
+      @base_command.gsub(/[^a-zA-Z0-9_]/, "_")
+    end
+
+    # Get the tool description for MCP
+    def tool_description
+      if @blueprint_args.any?
+        blueprint_desc = @blueprint_args.map { |arg| "{{#{arg[:name]}}}" }.join(" ")
+        "Run the shell command `#{@base_command} #{blueprint_desc}`"
+      else
+        "Run the shell command `#{@base_command} [args]`"
+      end
+    end
+
+    # Get the input schema for MCP tool
+    def input_schema
+      schema = {
+        type: "object",
+        properties: {}
+      }
+
+      if @blueprint_args.empty?
+        schema[:properties][:args] = {
+          type: "array",
+          items: { type: "string" },
+          description: "Additional command line arguments"
+        }
+      else
+        # Add blueprint arguments to schema
+        @blueprint_args.each do |blueprint_arg|
+          schema[:properties][blueprint_arg[:name].to_sym] = {
+            type: "string",
+            description: blueprint_arg[:description]
+          }
+        end
+      end
+
+      schema
+    end
+
+    private
+
+    def parse_blueprint_args(args)
+      blueprint_args = []
+
+      args.each do |arg|
+        # First check for templates with descriptions: {{name#description}}
+        arg.scan(/\{\{(\w+)\s*#\s*(.+?)\}\}/) do |name, description|
+          blueprint_args << { name: name, description: description.strip }
+        end
+
+        # Then check for templates without descriptions: {{name}}
+        # Only add if we haven't already found this name with a description
+        arg.scan(/\{\{(\w+)\}\}/) do |name|
+          name = name.first
+          unless blueprint_args.any? { |ba| ba[:name] == name }
+            blueprint_args << { name: name, description: "the {{#{name}}} arg" }
+          end
+        end
+      end
+
+      blueprint_args
+    end
+
+    # rubocop:todo Metrics/PerceivedComplexity
+    # rubocop:todo Metrics/AbcSize
+    # rubocop:todo Metrics/CyclomaticComplexity
+    def build_command(args) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+      command_parts = [@base_command]
+
+      # Add blueprint arguments if they exist
+      if @blueprint_args.any?
+        @argv.each do |arg|
+          # Check if this argument contains any blueprint patterns
+          processed_arg = arg.dup
+
+          # Replace templates with descriptions: {{name#description}}
+          processed_arg.gsub!(/\{\{(\w+)\s*#\s*.+?\}\}/) do |_match|
+            name = ::Regexp.last_match(1)
+            value = args[name.to_s] || args[name.to_sym]
+            value.to_s # Convert to string in case of nil
+          end
+
+          # Replace templates without descriptions: {{name}}
+          processed_arg.gsub!(/\{\{(\w+)\}\}/) do |_match|
+            name = ::Regexp.last_match(1)
+            value = args[name.to_s] || args[name.to_sym]
+            value.to_s # Convert to string in case of nil
+          end
+
+          command_parts << processed_arg
+        end
+      else
+        # Add original blueprint arguments
+        command_parts.concat(@argv)
+      end
+
+      # Add additional args
+      if args.is_a?(Hash) && (args["args"] || args[:args])
+        additional_args = args["args"] || args[:args]
+        command_parts.concat(additional_args) if additional_args
+      elsif args.is_a?(Array)
+        command_parts.concat(args)
+      end
+
+      command_parts.compact
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/PerceivedComplexity
+  end
+end

data/lib/studio/tool.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "mcp"
+
+module Studio
+  class Tool # rubocop:todo Style/Documentation
+    # rubocop:todo Metrics/AbcSize
+    def self.for_blueprint(blueprint) # rubocop:todo Metrics/AbcSize
+      Class.new(MCP::Tool) do
+        tool_name blueprint.tool_name
+        description blueprint.tool_description
+        input_schema blueprint.input_schema
+
+        define_singleton_method :call do |server_context:, **arguments| # rubocop:todo Lint/UnusedBlockArgument
+          result = blueprint.execute(arguments)
+
+          # Log stderr if present
+          warn "[Studio] #{result[:stderr]}" unless result[:stderr].empty?
+
+          if result[:success]
+            MCP::Tool::Response.new([{
+                                      type: "text",
+                                      text: result[:stdout]
+                                    }])
+          else
+            MCP::Tool::Response.new([{
+                                      type: "text",
+                                      text: result[:stdout]
+                                    }], true)
+          end
+        end
+      end
+    end
+    # rubocop:enable Metrics/AbcSize
+  end
+end

data/lib/studio/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Studio
+  VERSION = "0.1.0"
+end

data/lib/studio.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "open3"
+require "mcp"
+require "mcp/transports/stdio"
+
+require_relative "studio/version"
+require_relative "studio/blueprint"
+require_relative "studio/tool"
+
+module Studio # rubocop:todo Style/Documentation
+  class Error < StandardError; end
+
+  def self.serve(argv)
+    if argv.empty?
+      warn "Usage: studio <command> [blueprint_args...]"
+      exit 1
+    end
+
+    blueprint = Blueprint.new(argv)
+    tool_class = Tool.for_blueprint(blueprint)
+
+    server = MCP::Server.new(
+      name: "studio_server",
+      tools: [tool_class]
+    )
+
+    transport = MCP::Transports::StdioTransport.new(server)
+    transport.open
+  rescue StandardError => e
+    warn "Studio error: #{e.message}"
+    exit 1
+  end
+end

data/sig/studio.rbs

@@ -0,0 +1,4 @@
+module Studio
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: studio
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Martin Emde
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: Studio transforms any CLI command into a StdIO Model Context Protocol
+  (MCP) server. It exposes templated command-line tools so they can be executed more
+  easily and safely than free inputs.
+email:
+- me@martinemde.com
+executables:
+- studio
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/studio
+- lib/studio.rb
+- lib/studio/blueprint.rb
+- lib/studio/tool.rb
+- lib/studio/version.rb
+- sig/studio.rbs
+homepage: https://github.com/martinemde/studio
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/martinemde/studio
+  source_code_uri: https://github.com/martinemde/studio
+  changelog_uri: https://github.com/martinemde/studio/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Make any CLI command an MCP server
+test_files: []