pi-roblox-studio-tools

v0.3.0

Published

19 hours ago

On-demand Roblox Studio MCP tools for Pi without a long-running MCP server.

0High
0Medium
0Low

eiei114

pi-package pi roblox roblox-studio mcp typescript

Pi Roblox Studio Tools

On-demand Roblox Studio MCP tools for Pi without a long-running MCP server.

What this is

Pi Roblox Studio Tools adds Pi-native tools for working with Roblox Studio MCP while avoiding an always-on MCP server process.

The package locates the official StudioMCP command on Windows and macOS. MCP tools spawn StudioMCP only when a Pi tool call needs it, then shut it down after the request.

Features

Cross-platform StudioMCP path detection for Windows and macOS
Pi command: /roblox-studio-mcp-status
Pi tool: roblox_studio_mcp_status with initialize probe
Pi tool: roblox_studio_mcp_list_tools for read-only tools/list inventory
Pi tool: roblox_studio_mcp_list_studios for read-only open Studio instance inventory
Distinguishes missing StudioMCP from installed-but-not-callable states
Capped inventory output so large tool lists or stderr cannot flood Pi context
No persistent MCP process by default
No generic mutation tools/call wrapper in this package slice
TypeScript-first Pi package structure

Install

Install the published npm package with Pi:

pi install npm:pi-roblox-studio-tools

Install into the current project instead of your user Pi settings:

pi install npm:pi-roblox-studio-tools -l

Or install from GitHub:

pi install git:github.com/eiei114/pi-roblox-studio-tools

Try it without permanently installing:

pi -e npm:pi-roblox-studio-tools

Quick start

Try this package locally:

pi -e .

Then run:

/roblox-studio-mcp-status

The agent can also call:

roblox_studio_mcp_status
roblox_studio_mcp_list_tools
roblox_studio_mcp_list_studios

Status output reports whether StudioMCP was found and whether initialize succeeded. The inventory tools run only when StudioMCP is callable and return capped read-only diagnostics for exposed MCP tools and open Studio instances.

StudioMCP paths

Windows:

%LOCALAPPDATA%\Roblox\mcp.bat
%LOCALAPPDATA%\Roblox Studio\StudioMCP.exe

macOS:

/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
~/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Package contents

| Path | Purpose | |---|---| | extensions/ | Pi TypeScript extension entrypoints | | lib/ | Shared StudioMCP discovery and one-shot stdio MCP client helpers | | skills/ | Agent Skill for Roblox Studio MCP workflow guidance | | docs/ | Architecture, release, and setup docs |

Development

npm install
npm run ci
npm pack --dry-run

npm run ci runs npm run typecheck, npm test, npm run pack:check (npm pack --dry-run), and npm run publish:guard (fails if workflow files reference NPM_TOKEN or NODE_AUTH_TOKEN). Verify that publish workflows use npm Trusted Publishing (OIDC). Run npm pack --dry-run directly when you only need to verify the published tarball contents.

Release

This package uses npm Trusted Publishing with GitHub Actions OIDC, so no NPM_TOKEN is required.

npm version patch
git push

On main, a package.json version bump triggers auto-release, which creates the tag and dispatches publish.yml.

See docs/release.md for setup details.

Security

Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.

This package is designed to avoid a long-running MCP process. Studio mutation tools run without confirmation UI, so review tool names and arguments carefully.

For vulnerability reporting, see SECURITY.md.

License

MIT