MCP server that lets any AI agent control WorldBox via the WorldBoxBridge BepInEx mod.
Project description
worldbox-mcp (Python MCP server)
The Python half of worldbox-mcp. Distributed on PyPI.
uvx worldbox-mcp # stdio transport (default)
uvx worldbox-mcp --http # Streamable HTTP transport
uvx worldbox-mcp --help
See the top-level README and the docs site for full installation instructions and client configuration recipes.
Development
uv sync --all-extras
uv run pytest
uv run ruff check .
uv run mypy --strict src
Architecture
This package is a thin, typed façade over the WorldBoxBridge HTTP API. It:
- Speaks the MCP protocol to AI clients.
- Validates tool inputs with Pydantic.
- Translates each MCP
tools/callinto aPOST /cmdrequest against the local mod. - Maps bridge error codes to MCP errors with full preservation of detail (no swallowing).
See docs/architecture.md for the full picture.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file worldbox_mcp-0.1.0.tar.gz.
File metadata
- Download URL: worldbox_mcp-0.1.0.tar.gz
- Upload date:
- Size: 14.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
58a69181e0bbeeef02ea4b963ee2f3c9d3e526bb7cf45c84aa3c27c3bca35e7c
|
|
| MD5 |
2676b929e4698dfd7afe8371b60ae0d4
|
|
| BLAKE2b-256 |
4d02fd45e7e7751e76347cea748d4bf03dc2e9cca5709ee71614b6e11d7ff684
|
File details
Details for the file worldbox_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: worldbox_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 18.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8795570e3cb56067f61797c8759d6316e96709bc49ab1e79bd461f431b70ed0
|
|
| MD5 |
451572ff272b882c82d7eb0303bf0e93
|
|
| BLAKE2b-256 |
6ba0b63aca1cf14be7c643a1f5c6ad4ed43dbdbd0a634540ad9dfa514009c70b
|
