dcc-mcp-tracy
Tracy frame-profiler capture and offline zone analysis for DCC-MCP.
Tracy is a client/server profiler: the target must be built with Tracy instrumentation (C/C++, Rust, C#, Python, or another supported binding). This adapter controls the official tracy-capture and tracy-csvexport utilities; it does not inject Tracy into an uninstrumented process.
Install
pip install dcc-mcp-tracy
Install Tracy separately and set DCC_MCP_TRACY_CAPTURE and DCC_MCP_TRACY_CSVEXPORT, or put the utilities on PATH. On Windows, if neither is available, the adapter downloads and caches the official latest Tracy release automatically. Set DCC_MCP_TRACY_AUTO_DOWNLOAD=0 to require a local installation; use DCC_MCP_RUNTIME_CACHE to choose the cache root. Linux/macOS currently require explicit Tracy binaries because the official release does not ship those desktop bundles.
Workflow
- Build/run the instrumented game, engine, Unity native plugin, Unreal module, or gateway process.
- Call
tracy_capture__capture_tracewith the client address and.tracyoutput path. - Call
tracy_analysis__export_csv, thentracy_analysis__summarize_csvto identify high-variance zones.
The adapter invokes subprocesses with shell=False, validates trace/output extensions, and never accepts a shell command.
Development
uv sync --extra dev
uv run pytest
uv run ruff check src tests
Tracy is maintained independently at https://github.com/wolfpld/tracy.
Metadata
Release files for dcc-mcp-tracy 0.2.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dcc_mcp_tracy-0.2.6.tar.gz | 11.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dcc_mcp_tracy-0.2.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.3 kB
Release files / dcc_mcp_tracy-0.2.6.tar.gz
| Download URL | dcc_mcp_tracy-0.2.6.tar.gz |
|---|---|
| Size | 11.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e743f2a9a7e1f130456770475261c405ccb7764af23be68c028503375198921b
|
|
BLAKE2b-256 checksum How to use checksums |
bcf46b09ca33508df363ae5ce9640441a2e5eaa2bbb43445926dd82d01bb5f32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logRelease files / dcc_mcp_tracy-0.2.6-py3-none-any.whl
| Download URL | dcc_mcp_tracy-0.2.6-py3-none-any.whl |
|---|---|
| Size | 13.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
31dbdc24d0d55f5e01b7e5af827fc525fbe7884dd0ce5f5e55deecd0ac66de45
|
|
BLAKE2b-256 checksum How to use checksums |
8b6254b780cc54a18d7c3b68b5bb9cf6586b41ea880f3b739e187e1de14e7567
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency log
