dcc-mcp-core-semantic
Native Rust semantic embeddings for dcc-mcp-core,
shipped as a separate PyPI wheel so the main dcc-mcp-core install stays
free of ONNX Runtime and the ~25-40 MB wheel size that comes with it.
When to install this
Only when you actually need dense semantic recall for skill / capability
search. The default pip install dcc-mcp-core install ships with a
HashedEmbedder (zero-dep, hashing-trick + character n-grams) which is
enough for ≤100-skill DCC adapters and tolerates morphology variants
like render / rendering already.
If your skill catalogue grows to many hundreds of skills, or your agents
ask in natural language that does not share token structure with your
SKILL.md metadata, install this companion wheel to upgrade
OnnxEmbedder to true dense semantic recall.
How to install
pip install 'dcc-mcp-core[semantic]'
This pulls in dcc-mcp-core-semantic (this package) via the [semantic]
extra, plus fastembed as a Python-side fallback for platforms where the
Rust wheel is not yet available.
You can also install this package directly if you want only the Rust backend without the Python fallback:
pip install dcc-mcp-core dcc-mcp-core-semantic
How it gets used
Your adapter code does not change. Once installed,
dcc_mcp_core.OnnxEmbedder() automatically prefers the Rust extension:
from dcc_mcp_core import OnnxEmbedder, VectorSkillIndex
# Loads the BAAI/bge-small-en-v1.5 model on first use, cached to
# ~/.cache/fastembed/ (or wherever DCC_MCP_EMBED_MODEL_DIR points).
emb = OnnxEmbedder()
idx = VectorSkillIndex(embedder=emb)
Configuration
Both env vars are honoured by OnnxEmbedder regardless of which backend
serves the call:
| Variable | Default | Purpose |
|---|---|---|
DCC_MCP_EMBED_MODEL |
BAAI/bge-small-en-v1.5 |
HuggingFace model name. Must be one of dcc_mcp_core_semantic.native.SUPPORTED_MODELS. |
DCC_MCP_EMBED_MODEL_DIR |
unset (fastembed default) | On-disk cache for the ONNX model bytes. Pre-place this on a shared mount for firewalled studios. |
Build from source
The source lives in the main dcc-mcp-core repository, NOT here.
Rust crate: crates/dcc-mcp-semantic/. Wheel build:
cd pkg/dcc-mcp-core-semantic
maturin build --release
ONNX Runtime is pulled in at build time via the ort crate's
download-binaries strategy. The wheel that maturin produces is
self-contained — end users do not need to install ONNX Runtime separately.
License
MIT, matching dcc-mcp-core.
1 maintainer
Release files for dcc-mcp-core-semantic 0.20.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| dcc_mcp_core_semantic-0.20.25-cp38-abi3-win_amd64.whl | CPython 3.8 | abi3 | Windows x86-64 | Details |
| dcc_mcp_core_semantic-0.20.25-cp38-abi3-manylinux_2_28_x86_64.whl | CPython 3.8 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| dcc_mcp_core_semantic-0.20.25-cp38-abi3-macosx_11_0_arm64.whl | CPython 3.8 | abi3 | macOS 11.0+ ARM64 | Details |
| dcc_mcp_core_semantic-0.20.25-cp37-cp37m-win_amd64.whl | CPython 3.7 | CPython 3.7 pymalloc | Windows x86-64 | Details |
| dcc_mcp_core_semantic-0.20.25-cp37-cp37m-manylinux_2_28_x86_64.whl | CPython 3.7 | CPython 3.7 pymalloc | Linux glibc 2.28+ x86-64 | Details |
Total release size: 51.7 MB
Release files / dcc_mcp_core_semantic-0.20.25-cp38-abi3-win_amd64.whl
| Download URL | dcc_mcp_core_semantic-0.20.25-cp38-abi3-win_amd64.whl |
|---|---|
| Size | 10.3 MB |
| Tags | CPython 3.8 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4f6572639d5abcb83ca10bd5dff59ec3e2dc38855c45abbc6cab2a3192af875f
|
|
BLAKE2b-256 checksum How to use checksums |
c32cc9c73dc9cf105164b77a2168cce3792ae6096bb74817ccdf6830bf597129
|
| 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 Sep 10, 2026.
Transparency logRelease files / dcc_mcp_core_semantic-0.20.25-cp38-abi3-manylinux_2_28_x86_64.whl
| Download URL | dcc_mcp_core_semantic-0.20.25-cp38-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 10.8 MB |
| Tags | CPython 3.8 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
1052a4d3ae6049337c7b5730d8bd7155ebba0a0b344d1a38305616588a756ba6
|
|
BLAKE2b-256 checksum How to use checksums |
c7391626bcbf1a69e7994eee45b440b9cc960b0e7e7d78b6f113654352342fb0
|
| 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 Sep 10, 2026.
Transparency logRelease files / dcc_mcp_core_semantic-0.20.25-cp38-abi3-macosx_11_0_arm64.whl
| Download URL | dcc_mcp_core_semantic-0.20.25-cp38-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.8 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1e45adf19984d05682f4426eef5c50ced286475549602f2615f6757bb68c0057
|
|
BLAKE2b-256 checksum How to use checksums |
aee324ee0f762fb140bd85d617cad8535a0fcf48b094b94912ef85c3b90cbb20
|
| 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 Sep 10, 2026.
Transparency logRelease files / dcc_mcp_core_semantic-0.20.25-cp37-cp37m-win_amd64.whl
| Download URL | dcc_mcp_core_semantic-0.20.25-cp37-cp37m-win_amd64.whl |
|---|---|
| Size | 10.3 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6fe66c2706c2bb9b5bf6691771767da3a3d35316a03119d24c290045ccafacbc
|
|
BLAKE2b-256 checksum How to use checksums |
3d442fec6bd934928539c0830f0c159ab887238ee074344590d82d0707399299
|
| 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 Sep 10, 2026.
Transparency logRelease files / dcc_mcp_core_semantic-0.20.25-cp37-cp37m-manylinux_2_28_x86_64.whl
| Download URL | dcc_mcp_core_semantic-0.20.25-cp37-cp37m-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 10.8 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
2a0233cc85b41919f27f2d2bc8c553c6a3804261f69cf72e0ca4910ecf3009a8
|
|
BLAKE2b-256 checksum How to use checksums |
c4041fd5f8b7bc7e89e79273d3a24067efc4ec29e8160c848a90c5e2857bc52d
|
| 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 Sep 10, 2026.
Transparency log
