pi-roblox-studio-tools

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
• Distinguishes missing StudioMCP from installed-but-not-callable states
• No persistent MCP process by default
• 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

Status output reports whether StudioMCP was found and whether initialize succeeded.

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 typecheck, tests, and npm run pack:check (npm pack --dry-run). 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.

Links

• npm: https://www.npmjs.com/package/pi-roblox-studio-tools
• GitHub: https://github.com/eiei114/pi-roblox-studio-tools
• Issues: https://github.com/eiei114/pi-roblox-studio-tools/issues

License

MIT