{"id":29829811,"url":"https://github.com/suiramdev/sbox-mcp-library","last_synced_at":"2025-10-11T20:43:02.254Z","repository":{"id":300853957,"uuid":"1005245673","full_name":"suiramdev/sbox-mcp-library","owner":"suiramdev","description":"A MCP server for s\u0026box","archived":false,"fork":false,"pushed_at":"2025-07-28T21:04:43.000Z","size":3286,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-07-28T21:37:55.044Z","etag":null,"topics":["mcp","mcp-server","sbox","sbox-game","sbox-library","sbox-tool"],"latest_commit_sha":null,"homepage":"https://sbox.game/sdv/modelcontextprotocol","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/suiramdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-19T23:24:58.000Z","updated_at":"2025-07-28T21:31:40.000Z","dependencies_parsed_at":"2025-07-28T21:37:57.221Z","dependency_job_id":null,"html_url":"https://github.com/suiramdev/sbox-mcp-library","commit_stats":null,"previous_names":["suiramdev/sbox-mcp-server","suiramdev/sbox-mcp-library"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/suiramdev/sbox-mcp-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiramdev%2Fsbox-mcp-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiramdev%2Fsbox-mcp-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiramdev%2Fsbox-mcp-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiramdev%2Fsbox-mcp-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/suiramdev","download_url":"https://codeload.github.com/suiramdev/sbox-mcp-library/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suiramdev%2Fsbox-mcp-library/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267665283,"owners_count":24124503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","sbox","sbox-game","sbox-library","sbox-tool"],"created_at":"2025-07-29T09:40:56.214Z","updated_at":"2025-10-11T20:42:57.214Z","avatar_url":"https://github.com/suiramdev.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Model Context Protocol for s\u0026box\n\n[![.NET](https://img.shields.io/badge/.NET-9.0-blue)](https://dotnet.microsoft.com/)\n[![s\u0026box](https://img.shields.io/badge/s%26box-Compatible-orange)](https://sbox.game/)\n\n\u003e [!IMPORTANT]\n\u003e This project is currently under active development.\n\nA s\u0026box library that enables AI assistants to interact with the s\u0026box editor through the Model Context Protocol (MCP) via real-time WebSocket communication.\n\nThis adapter library works in conjunction with the separate [MCP Server](https://github.com/suiramdev/sbox-mcp-server) to provide seamless integration between AI assistants and your s\u0026box projects.\n\n![](./Assets/example_1.gif)\n\n## Prerequisites\n\n- [s\u0026box](https://sbox.game/) (latest version)\n- [MCP Server](https://github.com/suiramdev/sbox-mcp-server) (must be installed and running separately)\n- An MCP-compatible AI assistant (Claude Desktop, Cursor, etc.)\n\n## Quick Start\n\n### Step 1: Install and Run the MCP Server\n\nBefore using this adapter library, make sure the MCP Server is properly installed and running. This server acts as an API that enables your AI assistant to communicate with the library:\n\n1. **Download and set up the MCP Server** by following the detailed installation and configuration steps in the [sbox-mcp-server repository](https://github.com/suiramdev/sbox-mcp-server).\n\n### Step 2: Install the Adapter Library in s\u0026box\n\n1. **Install this library** in your s\u0026box project through the **Asset Library**. [Find it on asset.party](https://sbox.game/sdv/modelcontextprotocol)\n\nOnce the MCP Server is running:\n\n2. **Navigate to MCP → Connect to MCP Server** in the s\u0026box editor menu bar.\n\n3. **Listen for the connection confirmation**: You'll hear a success sound and see a success message in the console when connected.\n\n\u003e [!IMPORTANT]\n\u003e The MCP Server must be running for this adapter library to function. Please refer to the [MCP Server documentation](https://github.com/suiramdev/sbox-mcp-server) for detailed installation and configuration instructions.\n\n\n## Usage\n\nOnce both the MCP Server and this adapter library are installed and connected, you can interact with your s\u0026box project using natural language through your AI assistant:\n\n```\n\"Create a ModelRenderer component on the Cube object\"\n\"Find all game objects named 'Player'\"\n\"Set the Scale property of the Transform component on MainCamera to 2,2,2\"\n\"Remove the Rigidbody component from the Ball object\"\n\"Show me all components attached to the Ground object\"\n```\n\n## Architecture\n\nThis adapter library acts as a bridge between:\n- **s\u0026box Editor** ↔ **This Adapter Library** ↔ **MCP Server** ↔ **AI Assistant**\n\nThe adapter library:\n- Connects to the external MCP Server via WebSocket\n- Translates MCP commands into s\u0026box editor operations\n- Provides real-time feedback to AI assistants\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Related Repositories\n\n- **MCP Server**: [sbox-mcp-server](https://github.com/suiramdev/sbox-mcp-server) - The main server component\n- **This Library**: Adapter library for s\u0026box integration\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/suiramdev/sbox-mcp-library/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/suiramdev/sbox-mcp-library/discussions)\n- **MCP Server Support**: [MCP Server Issues](https://github.com/suiramdev/sbox-mcp-server/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuiramdev%2Fsbox-mcp-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuiramdev%2Fsbox-mcp-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuiramdev%2Fsbox-mcp-library/lists"}