Publish to Docker Hub (#468)
* Add GitHub Actions workflow for Docker Hub publishing * Remove TestPyPI publishing from PyPI workflow Removes the publish-to-testpypi job from the GitHub Actions workflow to streamline the publishing process and only publish to production PyPI. * Update Server/DOCKER_OVERVIEW.md Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> * Update .github/workflows/publish-docker.yml Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Align docker and pypi publishing so they update on new tags in the same way * Add caching to speed up pushes * Remove unnecessary permissions * Let's be super specific about the platform it should be Ubuntu's default but just in case --------- Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>main
parent
12e1b62b2e
commit
edd40ec86e
|
|
@ -0,0 +1,47 @@
|
||||||
|
name: Publish Docker image 🐳
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- "*"
|
||||||
|
workflow_dispatch:
|
||||||
|
jobs:
|
||||||
|
push_to_registry:
|
||||||
|
name: Push Docker image to Docker Hub
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Check out the repo
|
||||||
|
uses: actions/checkout@v6
|
||||||
|
|
||||||
|
- name: Log in to Docker Hub
|
||||||
|
uses: docker/login-action@v3
|
||||||
|
with:
|
||||||
|
username: ${{ secrets.DOCKER_USERNAME }}
|
||||||
|
password: ${{ secrets.DOCKER_PASSWORD }}
|
||||||
|
|
||||||
|
- name: Extract metadata (tags, labels) for Docker
|
||||||
|
id: meta
|
||||||
|
uses: docker/metadata-action@v5
|
||||||
|
with:
|
||||||
|
images: ${{ secrets.DOCKER_USERNAME }}/mcp-for-unity-server
|
||||||
|
tags: |
|
||||||
|
type=semver,pattern={{version}}
|
||||||
|
type=semver,pattern={{major}}.{{minor}}
|
||||||
|
type=ref,event=branch
|
||||||
|
type=sha
|
||||||
|
|
||||||
|
- name: Set up Docker Buildx
|
||||||
|
uses: docker/setup-buildx-action@v3
|
||||||
|
|
||||||
|
- name: Build and push Docker image
|
||||||
|
uses: docker/build-push-action@v6
|
||||||
|
with:
|
||||||
|
context: .
|
||||||
|
file: Server/Dockerfile
|
||||||
|
platforms: linux/amd64
|
||||||
|
push: true
|
||||||
|
tags: ${{ steps.meta.outputs.tags }}
|
||||||
|
labels: ${{ steps.meta.outputs.labels }}
|
||||||
|
cache-from: type=gha
|
||||||
|
cache-to: type=gha,mode=max
|
||||||
|
|
@ -1,6 +1,10 @@
|
||||||
name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
|
name: Publish Python 🐍 distribution 📦 to PyPI
|
||||||
|
|
||||||
on: push
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- "*"
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
build:
|
build:
|
||||||
|
|
@ -32,7 +36,6 @@ jobs:
|
||||||
publish-to-pypi:
|
publish-to-pypi:
|
||||||
name: >-
|
name: >-
|
||||||
Publish Python 🐍 distribution 📦 to PyPI
|
Publish Python 🐍 distribution 📦 to PyPI
|
||||||
if: startsWith(github.ref, 'refs/tags/') # only publish to PyPI on tag pushes
|
|
||||||
needs:
|
needs:
|
||||||
- build
|
- build
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
|
|
@ -50,27 +53,3 @@ jobs:
|
||||||
path: dist/
|
path: dist/
|
||||||
- name: Publish distribution 📦 to PyPI
|
- name: Publish distribution 📦 to PyPI
|
||||||
uses: pypa/gh-action-pypi-publish@release/v1
|
uses: pypa/gh-action-pypi-publish@release/v1
|
||||||
|
|
||||||
publish-to-testpypi:
|
|
||||||
name: Publish Python 🐍 distribution 📦 to TestPyPI
|
|
||||||
needs:
|
|
||||||
- build
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
environment:
|
|
||||||
name: testpypi
|
|
||||||
url: https://test.pypi.org/p/mcpforunityserver
|
|
||||||
|
|
||||||
permissions:
|
|
||||||
id-token: write # IMPORTANT: mandatory for trusted publishing
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: Download all the dists
|
|
||||||
uses: actions/download-artifact@v7
|
|
||||||
with:
|
|
||||||
name: python-package-distributions
|
|
||||||
path: dist/
|
|
||||||
- name: Publish distribution 📦 to TestPyPI
|
|
||||||
uses: pypa/gh-action-pypi-publish@release/v1
|
|
||||||
with:
|
|
||||||
repository-url: https://test.pypi.org/legacy/
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,88 @@
|
||||||
|
# MCP for Unity Server (Docker Image)
|
||||||
|
|
||||||
|
[](https://modelcontextprotocol.io/introduction)
|
||||||
|
[](https://opensource.org/licenses/MIT)
|
||||||
|
[](https://discord.gg/y4p8KfzrN4)
|
||||||
|
|
||||||
|
Model Context Protocol server for Unity Editor integration. Control Unity through natural language using AI assistants like Claude, Cursor, and more.
|
||||||
|
|
||||||
|
**Maintained by [Coplay](https://www.coplay.dev/?ref=unity-mcp)** - This project is not affiliated with Unity Technologies.
|
||||||
|
|
||||||
|
💬 **Join our community:** [Discord Server](https://discord.gg/y4p8KfzrN4)
|
||||||
|
|
||||||
|
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
### 1. Pull the image
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull msanatan/mcp-for-unity-server:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Run the server
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run -p 8080:8080 msanatan/mcp-for-unity-server:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
This starts the MCP server on port 8080.
|
||||||
|
|
||||||
|
### 3. Configure your MCP Client
|
||||||
|
|
||||||
|
Add the following configuration to your MCP client (e.g., Claude Desktop config, Cursor settings):
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"UnityMCP": {
|
||||||
|
"url": "http://localhost:8080/mcp"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
The server connects to the Unity Editor automatically when both are running. No additional configuration is needed.
|
||||||
|
|
||||||
|
**Environment Variables:**
|
||||||
|
|
||||||
|
- `DISABLE_TELEMETRY=true` - Opt out of anonymous usage analytics
|
||||||
|
- `LOG_LEVEL=DEBUG` - Enable detailed logging (default: INFO)
|
||||||
|
|
||||||
|
Example running with environment variables:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run -p 8080:8080 -e LOG_LEVEL=DEBUG msanatan/mcp-for-unity-server:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Example Prompts
|
||||||
|
|
||||||
|
Once connected, try these commands in your AI assistant:
|
||||||
|
|
||||||
|
- "Create a 3D player controller with WASD movement"
|
||||||
|
- "Add a rotating cube to the scene with a red material"
|
||||||
|
- "Create a simple platformer level with obstacles"
|
||||||
|
- "Generate a shader that creates a holographic effect"
|
||||||
|
- "List all GameObjects in the current scene"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
For complete documentation, troubleshooting, and advanced usage, please visit the GitHub repository:
|
||||||
|
|
||||||
|
📖 **[Full Documentation](https://github.com/CoplayDev/unity-mcp#readme)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT License - See [LICENSE](https://github.com/CoplayDev/unity-mcp/blob/main/LICENSE)
|
||||||
Loading…
Reference in New Issue