studio-mcp/studio
If you are the rightful owner of studio and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Studio MCP is a simple Model Context Protocol server that transforms any CLI command into an MCP tool.
Studio MCP
Make any CLI into a single tool MCP server.
Bright Studio Apt – No Walls, No Rules – $0/mo OBO.
No questions. Cash only. Basement-ish. Just enough, nothing more.
Text 404 to /dev/null for more details!
What's Included?
studio
is the simplest possible stdio Model Context Protocol server.
Everything after the studio
command will be turned into an MCP tool that runs just that command when called by Cursor, Claude, etc.
studio
is great for debugging MCPs or providing custom scripts to your LLM without having to deal with MCP.
It uses a very simple Mustache-like template syntax in order to tell the LLM how to use your MCP command.
$ npx -y @studio-mcp/studio command "{{ required_argument # Description of argument }}" "[optional_args... # any array of arguments]"
studio
turns this into an input schema for the MCP tool so that tool calls know what to send:
{
"type": "object",
"properties": {
"required_argument": { "type": "string", "description": "Description of argument" },
"optional_args": { "type": "array", "items": { "type": "string" }, "description": "any array of arguments" }
},
"required": ["required_argument"]
}
You can run almost any command, but you might need to put the full path for scripts or commands installed via other package managers. Just run which cmd
to find it's full path.
Since you're just renting the place, please be a good tenant and don't rm -rf
anything.
Move-In
These install instructions are like my lease agreement: full of gotchas. Have your lawyer read it over. (You do have a lawyer right?)
You can install to your system with npm
, use npx
directly, or install with go install github.com/studio-mcp/studio@latest
npm install -g @studio-mcp/studio
Or download directly from GitHub Releases and add to your PATH yourself.
Unpack (it's an apartment metaphor)
Most MCPs don't run in your shell environment 😭 You'll probably need to add the full path somewhere.
We'll use the MacOS say
command as an example command. If you're not on a Mac, use echo
(it's worse than useless, but it's easy to understand).
Claude Desktop
Go to the Claude Desktop settings and click Developer > Edit Config.
It should open your Claude Desktop MCP configuration. (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json
on Mac):
{
"mcpServers": {
"say": {
"command": "@studio-mcp/studio",
"args": ["-y", "@studio-mcp/studio", "say", "-v", "siri", "{{speech # A concise message to say outloud}}"]
},
}
}
Cursor
Add to your ~/.cursor/mcp.json
(in your home or project directory) or go to Tools section of the Cursor UI.
{
"mcpServers": {
"say": {
"command": "npx",
"args": ["-y", "@studio-mcp/studio", "say", "-v", "siri", "{{speech # A concise message to say outloud}}"]
},
}
}
VSCode
It's a lot of the same here.
{
"mcp": {
"servers": {
"echo": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@studio-mcp/studio", "echo", "{{text#What do you want to say?}}"]
}
}
}
}
Blueprint Syntax
Studio uses blueprints (templates) to keep your studio tidy.
studio say -v "{{voice# Choose your Mac say voice}}" "[args...#Any additional args]"
This creates a Studio server with two arguments: voice
and args
.
Everything after the #
will be used as the description for the LLM to understand.
Blueprint templates are a modified mustache format with descriptions: {{name # description}}
but they also add shell like optional [--flag]
booleans, [optional # an optional string]
and [args... # array with 0 or more strings]
for additional args:
{{name}}
: Required string argument[name]
: Optional string argument[name...]
: Optional array argument (spreads as multiple command line args)[--flag]
: Optional boolean namedflag
that prints--flag
only when true.{{name...}}
: Required array (1 or more arguments required).
Inside a tag, there is a name and description:
name
: The argument name that will be shown in the MCP tool schema. Only letter numbers and underscores (dashes and underscores are interchangeable, case-insensitive).description
: A description of what the argument should contain. Reads everything after the#
to the end of the template tag.
What about {{cool_template_feature: string /[A-Z]+/ # Fancy tags}}?
This is a simple studio, not one of those fancy 1 bedroom flats.
Maybe the landlord will get around to it at some point (but your rent will go up).
Utilities Included
To build and test locally:
make
make test
studio echo "{{text # what you want said to you}}"
Did something break?
The landlord definitely takes care of the place...
- more than none tests
- files! lots of 'em!
- maybe even some test coverage
- you still need Proof of Renters Insurance
Uncovered portions are tenant's responsibility. (no one appreciates how hard it is for us landlords)
Home Is Where You Make It
This is your studio too. Bugs, bedbugs, features, ideas? Swing by the repo during open-house:
🏠 https://github.com/studio-mcp/studio
Lease Terms: MIT
Move in under standard terms, no fine print. Full text here: MIT License.