Sharp MCP Server
Integrates with Blender via optional auto-install and the mcp-for-blender addon, enabling 3D asset pipelines, rigging and equipment attachment, animation compilation, and Cycles PBR baking through direct socket or headless execution.
Provides AI image generation and Gemini-backed vision QA for GUI and media inspections, including management of Gemini API credentials outside version control.
Connects to Roblox Studio through the SharpBridgePlugin to inspect and modify live places, including GUI building, inspection and patching, terrain and environment generation, script scaffolding, rigging and animation, audits, snapshots, and undo operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sharp MCP Server Audit my Roblox map for overlapping parts and fix glitches"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sharp MCP Server (sharp-mcp v0.4.0) & SharpBridgePlugin.rbxmx
License Notice (Private Non-Commercial Pre-Release): All Rights Reserved — Non-Commercial Internal Evaluation Only (
LICENSE,"private": true). Commercial use, SaaS hosting, public publishing, or third-party redistribution are prohibited without explicit written consent.
Cross-platform Model Context Protocol (MCP) server unifying Roblox Studio (SharpBridgePlugin.rbxmx), an Automatic Skill Distributor (SkillRouter), Concept Intake & Micro-Step MVP Planner (sharp_game_plan), Multimodal Playtest Video, Soundtest DSP & Vision GUI QA (sharp_media_qa), Anti-Slop Procedural 2D Art, Custom Bitmap Fonts, 2D/3D VFX & AI Image Studio (sharp_art_studio + sharp_ai_studio), 3D Map Overlap/Glitch Auditor (audit_overlaps/fix_overlaps), Surgical Live GUI Tools (sharp_gui_inspect / sharp_gui_patch / sharp_visual_diff), Offline Game-Dev Toolchain Orchestration (Rojo, Lune, Selene, StyLua), and Optional Auto-Installable Blender 3D/Animation Execution.
1. Quick Start (npx / uv / Python CLI)
First-class target clients: Antigravity, Claude (Claude Code & Claude Desktop), OpenAI Codex CLI, and OpenCode (V2).
Requires Python >=3.11 and mcp>=1.7.0,<2: 1.7 adds the tool annotations Sharp uses; MCP 2.x removed mcp.server.fastmcp. doctor checks actual server importability. For OpenCV-backed media QA, install the optional extra with python -m pip install '.[media]' (opencv-python-headless); video analysis falls back to ffmpeg on PATH when OpenCV is unavailable.
# Run doctor diagnostics without mutating your open Studio place
npx --yes ./06_sharp_mcp_server doctor
# Or via Python CLI:
python -m sharp_mcp.cli doctor
# Manage OpenRouter & Gemini API keys cleanly OUTSIDE version control (~/.sharp-mcp/credentials.json)
python -m sharp_mcp.cli keys status
python -m sharp_mcp.cli keys models
python -m sharp_mcp.cli keys set --provider openrouter --stdin
python -m sharp_mcp.cli keys set --provider gemini --stdin
# Register Sharp across Antigravity, Claude, Codex, and OpenCode (atomic JSON/TOML merge + .bak)
python -m sharp_mcp.cli register --client all --prune-legacy
# Install SharpBridgePlugin.rbxmx into Roblox Studio Plugins (%LOCALAPPDATA%\Roblox\Plugins or ~/Documents/Roblox/Plugins)
python -m sharp_mcp.cli install-plugin
# Check or auto-install Blender + mcp-for-blender addon (winget/brew + headless addon enable)
python -m sharp_mcp.cli install-blender --dry-runRelated MCP server: Roblox AI Skills
2. Architecture Overview
Component | Path | Description |
CLI & |
| Cross-platform Node ESM wrapper delegating cleanly to Python |
External AI Keys Store |
| Stores |
Client Registrar |
| Atomic config registration with |
Skill Router ( |
| Indexes 13 local skills (9 Roblox + 4 optional Blender), built-in Studio |
Effects, Annotations & Pagination |
| Declarative |
Security-Hardened Bridge |
| Async loopback broker ( |
Single-Use Transient HTTP |
| Ephemeral |
Standalone Studio Plugin |
| Built by |
Domain Engines |
|
|
Game Plan & Asset Library |
| Project-relative |
3. MCP Profiles, Tools (34 / 30 / 11), Resources (4 fixed + 1 template) & Prompts (5)
--profile full(34 tools, default): Full Roblox Studio + Design System + Art Studio + AI Studio + Multimodal Media QA + Equipment Attach + Micro-MVP Planner + Critical Audit + Toolchain + Blender suite.--profile core(30 tools): Studio + Design + Art + AI + Media QA + Planner + Audit + Toolchain (omitssharp_blender_setup,sharp_blender_rig_and_anim,sharp_blender_asset_pipeline, andsharp_equipment_attach).--profile blender(11 tools): Focused 3D asset, rigging, equipment attachment, animation, routing, and library subset.
Active Tools
sharp_route_task— Token-budgeted task classifier (detail="summary"<3 KBor"complete"withsubagent_delegations) and execution DAG planner.sharp_load_skill— On-demand loader for the 13 domain skills, references, and scripts.sharp_studio_status— Plugin bridge,HttpEnabled, Blender detection, and session skill status.sharp_blender_setup— Detect or auto-install Blender (winget/brew) and themcp-for-blenderaddon.sharp_terrain_build— Chunked 4x4x4 voxel biome builder (WriteVoxelChannels) or offline heightmap/colormap PNGs.sharp_environment_apply— 13 Lighting/Atmosphere/Clouds/ColorGrading presets + environment audit.sharp_gui_slice_and_pack— Pillow 9-slice border detector, generalized RxC / trimmed icon atlas packer, and.rbxmxGUI exporter.sharp_gui_build— Responsive cross-platform 11-layerStarterGuibuilder withUIKit.Assetsinjection & persisteddesign_systemtokens.sharp_gui_inspect— Semantic liveStarterGui/PlayerGuiinspector (AbsoluteSize/Position,StyleRules,IsPropertyModified, GUIDSharpHandles).sharp_gui_patch— Surgical non-destructive property/StyleRule/ResetPropertyToDefaultpatcher with readback diff +SharpUndo.sharp_visual_diff— Deterministic Pillow + numpy RGBA screenshot pixel diff, bounding box delta, blank-frame check, and optionalStudioDeviceSimulatorServiceQA.sharp_rig_and_animation— Live rig prober,KeyframeSequence/CurveAnimationcompiler, and.rbxmxexporter.sharp_blender_rig_and_anim— Blenderbpyrig/motion compiler with direct socket or headless execution.sharp_blender_asset_pipeline— Modular 3D asset & Cycles PBR bake compiler with direct socket or headless execution.sharp_luau_scaffold— Canonical Explorer containers,SafeRemoteGateway, tree search, andScriptEditorServiceediting.sharp_audit_all— Multi-domain static & live Studio auditor withSnapshotViewStorepagination.sharp_snapshot_and_undo— Full-placecheckpoint/restorezero-diff baseline engine andChangeHistoryService:Undo().sharp_combat_and_controllers— PhysicsControllerManager,Motor6Dtools, and server-validated hitboxes/projectiles.sharp_audio_vfx_cutscenes— Node-based Audio API bus graph, burstParticleEmitterpresets, 28-slotHighlightpool, and splines.sharp_data_economy_monetization— Session-lockedDataStoreService:UpdateAsync(with Studio mock fallback), economy, andProcessReceipt.sharp_ai_and_gameplay_systems—CollectionServiceNPC AI FSM +PathfindingService,ProximityPromptdialogues, and wave directors.sharp_world_assembly_and_optimization— Poisson scatter, socket snapping, OBB overlap/floating audits, and streaming optimization.audit_overlapsreturnsoverlapCount,floatingCount, andallClean;fix_overlapsiteratively separates smaller eligible assets, grounds assets with raycast hits, and returns final remaining counts.float_tolerance_studs=0.5(clamped 0–512) andmax_iterations=8(1–64) control repair.SharpLocked=trueprevents movement;SharpAllowFloating=trueopts out of floating checks, as do unanchored assets. Locked conflicts, voids, and iteration limits can leaveallClean=false; feed the result asworld_statstosharp_critical_audit. Ground checks sample the center and four inset bottom-face corners of the OBB's projected footprint, using the smallest signed gap to preserve end-supported bridges; no hits means void.floatingCountalso includes sunk assets (kind="embedded", negative signedgapStuds); grounding raises these assets rather than hiding penetration below the support surface.sharp_game_library— Project plan, version snapshots/diffs/rollbacks, relative asset registry, and StudioSharpAssetRegistry.luausync.sharp_playtest_scenario— Automated server-side gameplay smoke-test bot runner.sharp_toolchain— OfflineRojodefault.project.json,StyLua,Selene,Lune,Wally, andRokitorchestrator.sharp_inspect_snapshot_view— Paged inspection (offset,limit,json_path) of cached large snapshots/outputs.sharp_upstream_call— Optional forwarder when externalRoblox_StudioMCP is explicitly configured.sharp_design_system— Bespoke per-game palette/typography/UI-token generator (presets,generatewith auto-persistence,get, anti-sloplint,compile_theme_luau,image_prompts,render_swatch).sharp_equipment_attach— R15 weapon/armor/IK attachment compiler (attach,verify,catalog,validate,load_sidecar,generate_preset_clip,analyze_clip,compile_playback_test,blender_attach; enabled infull+blender).sharp_game_plan— Concept intake & MVP-first structured game planner (intake_questions,createwithgranularity='standard'|'micro',status,next_step,subagent_brief,complete_step,stages,cut_list,set_design_system).sharp_critical_audit— Skeptical release auditor & stage gate (static,live,challenge,gate) includingWORLD-OVERLAP-001&WORLD-FLOAT-001, returningSHIP/FIX_FIRST/REJECT.sharp_ai_studio— External Gemini & OpenRouter credentials (keys_status,keys_set,keys_clear,model_presets), bespoke UI concept generator (generate_ui_concept), and palette-locked AI art generator (generate_image_art).sharp_media_qa— Multimodal QA engine (inspect_videofor playtest/animation video telemetry + contact sheet + Gemini/OpenRouter analysis,inspect_audiosoundtest DSP + Gemini audio check,inspect_gui_visionanti-slop screenshot QA, andbatch_check).sharp_art_studio— Code-driven 2D/3D game art & VFX suite (create_2d_kit2x SSAA 9-slice/icons,create_font_kitRoblox fonts + custom stroked BitmapFont +SharpBitmapFont.luau,create_vfx4×4 flipbooks +SharpUiVfx.luau/SharpWorldVfx.luau, andgenerate_ai_art).
Resources (4 fixed + 1 template) & Prompts (5)
Fixed resources:
sharp://skills/catalog,sharp://game-library/plan,sharp://game-library/manifest,sharp://game-library/registry-luauResource template:
sharp://skills/{skill_name}/SKILL.mdPrompts:
sharp_new_game_workflow,sharp_fix_gui_loop,sharp_concept_intake_workflow,sharp_mvp_build_loop,sharp_ui_antislop_pass
4. Rebuilding Plugin & Running Tests
Luau compile regression tests run when luau-compile is on PATH or LUAU_COMPILE points to its executable; otherwise they skip. They syntax-check plugin/skill sources and representative generated Luau.
# Rebuild SharpBridgePlugin.rbxmx (29 embedded --!strict ModuleScripts) & install to Studio Plugins
python -m sharp_mcp.cli install-plugin
# Run isolated automated unit, security, wrapper, registration, plugin, and stdio MCP E2E suite
python -m unittest discover -s tests -p "test_*.py" -vAvailable Tools
34 toolssharp_ai_and_gameplay_systemsD
Inputs: action, max_waves, studio_id, default_map, +5 more. Returns: result
sharp_ai_studioD
Inputs: grid, tier, genre, model, +15 more. Returns: result
sharp_art_studioD
Inputs: grid, tier, genre, model, +12 more. Returns: result
sharp_audio_vfx_cutscenesD
Inputs: action, studio_id, root_prefix, master_volume, +5 more. Returns: result
sharp_audit_allDRead-onlyIdempotent
Inputs: detail, domains, log_type, log_limit, +8 more.
sharp_blender_asset_pipelineD
Inputs: execute, asset_kind, asset_name, output_dir, +4 more. Returns: result
sharp_blender_rig_and_animD
Inputs: fps, execute, export_fbx, output_dir, +4 more. Returns: result
sharp_blender_setupDIdempotent
Inputs: action, dry_run, auto_install, enable_addon, +1 more. Returns: result
sharp_combat_and_controllersD
Inputs: action, studio_id, weapon_id, base_damage, +6 more. Returns: result
sharp_critical_auditDRead-onlyIdempotent
Inputs: mode, detail, domains, step_id, +22 more.
sharp_data_economy_monetizationD
Inputs: action, studio_id, store_name, root_prefix, +4 more. Returns: result
sharp_design_systemDIdempotent
Inputs: mood, seed, genre, action, +10 more. Returns: result
sharp_environment_applyDDestructiveIdempotent
Inputs: overrides, studio_id, preset_name, run_audit_after, +4 more. Returns: result
sharp_equipment_attachD
Inputs: fps, mode, slot, action, +51 more.
sharp_game_libraryDDestructive
Inputs: tags, genre, query, action, +17 more.
sharp_game_planD
Inputs: genre, pitch, title, action, +10 more. Returns: result
sharp_gui_buildDDestructive
Inputs: studio_id, design_system, atlas_asset_id, panel_asset_id, +6 more. Returns: result
sharp_gui_inspectDRead-onlyIdempotent
Inputs: width, action, detail, height, +10 more.
sharp_gui_patchDDestructive
Inputs: path, patches, sharp_handle, set_properties, +4 more.
sharp_gui_slice_and_packDIdempotent
Inputs: max_dim, cell_size, grid_cols, grid_rows, +10 more. Returns: result
sharp_inspect_snapshot_viewDRead-onlyIdempotent
Inputs: view_id (required), limit, offset, json_path.
sharp_load_skillDRead-onlyIdempotent
Inputs: skill_name (required), section, include_scripts, max_script_lines, +1 more. Returns: result
sharp_luau_scaffoldD
Inputs: tag, path, limit, query, +17 more.
sharp_media_qaDIdempotent
Inputs: tier, focus, model, action, +12 more. Returns: result
sharp_playtest_scenarioDDestructive
Inputs: scenario, studio_id, cleanup_after, execute_in_studio, +3 more.
sharp_rig_and_animationD
Inputs: action, rig_path, clip_name, studio_id, +9 more.
sharp_route_taskDRead-onlyIdempotent
Inputs: task_description (required), detail, max_skills, target_domains, +1 more. Returns: result
sharp_snapshot_and_undoDDestructive
Inputs: action, probe_max, probe_min, studio_id, +4 more.
sharp_studio_statusDRead-onlyIdempotent
Inputs: check_blender, include_toolchain, include_plugin_install.
sharp_terrain_buildDDestructive
Inputs: seed, biome, studio_id, max_corner, +13 more. Returns: result
sharp_toolchainDIdempotent
Inputs: action, check_only, output_file, script_args, +4 more. Returns: result
sharp_upstream_callDDestructive
Inputs: tool_name (required), arguments, timeout_sec.
sharp_visual_diffDIdempotent
Inputs: after_path (required), before_path (required), threshold, diff_out_path. Returns: result
sharp_world_assembly_and_optimizationADestructive
Audit or iteratively fix OBB overlaps and floating anchored top-level assets.
Floating checks ignore models containing unanchored parts and assets with SharpAllowFloating=true. Repairs never move SharpLocked assets. Grounding requires a raycast hit; voids remain unresolved. float_tolerance_studs is clamped to 0..512 and max_iterations to 1..64. Pass the returned result as world_stats to sharp_critical_audit(mode="static" or "gate"): overlapCount/floatingCount reflect the final re-audit, also available as remainingOverlapCount/remainingFloatingCount after repairs. allClean is false when locked assets, voids, or iteration limits prevent repair. fixedCount counts movement operations, including grounding.
Inputs: seed, action, max_xz, min_xz, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 34 tools
Several clusters overlap heavily: sharp_rig_and_animation vs sharp_blender_rig_and_anim, sharp_gui_build/patch/inspect/slice_and_pack, sharp_ai_studio vs sharp_ai_and_gameplay_systems, and sharp_audit_all vs sharp_critical_audit. With almost all tool descriptions empty, an agent has little basis for choosing between these variants.
All tools share the sharp_ prefix and snake_case, so the surface is visually consistent. However, names mix action-first verbs (sharp_load_skill), domain-first compounds (sharp_gui_build), and conjunction-heavy feature labels (sharp_combat_and_controllers), so there is no predictable verb_noun pattern.
34 tools is heavy for a single MCP server, and the count appears inflated by overlapping studio, rigging, audit, GUI, and AI variants. Several tools look like they could be consolidated into broader operations.
The surface spans a broad Roblox/game-development pipeline including skills, routing, Blender, terrain, GUI, rigging, audit, AI, audio, design, and playtesting. However, with blank descriptions it is impossible to verify lifecycle coverage within each area, and notable operation-level gaps are likely.
Related MCP Connectors
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Related MCP Servers
- AlicenseBqualityBmaintenanceUnifies Roblox Studio, Unity, Unreal Engine, and Blender into a single AI-powered control plane with 78 tools for automated game development.78AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceBridges coding agents with Roblox Studio, enabling inspection, generation, editing, and validation of Roblox places through natural language.MIT
- AlicenseCqualityDmaintenanceProvides an MCP runtime that turns Roblox Studio into an AI-native, autonomous, bidirectional development platform, letting AI assistants create and edit scenes, models, animations, scripts, and game systems through 63+ tools. It integrates with the official Roblox Studio MCP and uses 11 specialized providers for modeling, animation, Luau, testing, and diagnostics.941MIT
- AlicenseCqualityBmaintenanceEnables AI agents to build game assets in Blender by modeling, lighting, rendering previews to inspect and correct, validating against engine budgets, and exporting to GLB/FBX.126MIT