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_trace with the client address and .tracy output path.
Call tracy_analysis__export_csv, then tracy_analysis__summarize_csv to 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dcc_mcp_tracy-0.2.0.tar.gz (8.4 kB view details)

Uploaded Jul 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dcc_mcp_tracy-0.2.0-py3-none-any.whl (12.5 kB view details)

Uploaded Jul 23, 2026 Python 3

File details

Details for the file dcc_mcp_tracy-0.2.0.tar.gz.

File metadata

Download URL: dcc_mcp_tracy-0.2.0.tar.gz
Upload date: Jul 23, 2026
Size: 8.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dcc_mcp_tracy-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`454e483cb0f327d3c20971a32f68722087ca139b5d1e95e563c664626833509a`
MD5	`c3628ab825c22f81522fe11ce01e17f3`
BLAKE2b-256	`7e81764f7b0209e6121a73d9a1f8c45feb45152bb66229e97547fbe451c5382f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dcc_mcp_tracy-0.2.0.tar.gz:

Publisher: release.yml on dcc-mcp/dcc-mcp-tracy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dcc_mcp_tracy-0.2.0.tar.gz
- Subject digest: 454e483cb0f327d3c20971a32f68722087ca139b5d1e95e563c664626833509a
- Sigstore transparency entry: 2226622381
- Sigstore integration time: Jul 23, 2026
Source repository:
- Permalink: dcc-mcp/dcc-mcp-tracy@976d9a919a9a65ccf5123251a9bb93ab291f4015
- Branch / Tag: refs/heads/main
- Owner: https://github.com/dcc-mcp
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@976d9a919a9a65ccf5123251a9bb93ab291f4015
- Trigger Event: push