omp packages

pi-roblox-studio-tools0.3.5

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

GitHub Actions Published 8 hours ago MIT ~566 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

Pi Roblox Studio Tools

Join dotfield.xyz on Discord

CI Publish npm version npm downloads License: MIT Pi package npm Provenance Buy Me A Coffee

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

Setup and verification

For supported platforms, prerequisites, install options, and the end-user status → inventory verification path, see docs/setup.md.

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.

For a copy-and-run status → inventory workflow, see docs/examples.md.

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/ Setup, architecture, release, and examples

Development

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

npm run ci runs npm run typecheck, npm test, npm run smoke:pi, npm run pack:check (npm pack --dry-run), and npm run publish:guard (fails if workflow files reference NPM_TOKEN or NODE_AUTH_TOKEN). The Pi smoke uses the installed SDK in an isolated RPC process to check extension registration, status responses, a handled missing-StudioMCP case, reload/cleanup, and the native host shell; it makes no model requests. 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.

Ordinary main merges, including version bumps, run CI only. They do not create tags or releases and do not publish to npm. Release creation requires separate authorization and a manual dispatch of .github/workflows/auto-release.yml on main.

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

License

MIT