Read-only MCP server for ROS2 and DDS: topics, participants, QoS mismatches, bags.
Connect Runs on your machine
claude mcp add topicforge -e TOPICFORGE_MODE=<TOPICFORGE_MODE> -e TOPICFORGE_DDS_BACKEND=<TOPICFORGE_DDS_BACKEND> -e TOPICFORGE_DDS_DOMAIN_ID=<TOPICFORGE_DDS_DOMAIN_ID> -e TOPICFORGE_TELEMETRY=<TOPICFORGE_TELEMETRY> -- uvx topicforge==0.11.0{
"mcpServers": {
"topicforge": {
"command": "uvx",
"args": [
"topicforge==0.11.0"
],
"env": {
"TOPICFORGE_MODE": "<TOPICFORGE_MODE>",
"TOPICFORGE_DDS_BACKEND": "<TOPICFORGE_DDS_BACKEND>",
"TOPICFORGE_DDS_DOMAIN_ID": "<TOPICFORGE_DDS_DOMAIN_ID>",
"TOPICFORGE_TELEMETRY": "<TOPICFORGE_TELEMETRY>"
}
}
}
}{
"mcpServers": {
"topicforge": {
"command": "uvx",
"args": [
"topicforge==0.11.0"
],
"env": {
"TOPICFORGE_MODE": "<TOPICFORGE_MODE>",
"TOPICFORGE_DDS_BACKEND": "<TOPICFORGE_DDS_BACKEND>",
"TOPICFORGE_DDS_DOMAIN_ID": "<TOPICFORGE_DDS_DOMAIN_ID>",
"TOPICFORGE_TELEMETRY": "<TOPICFORGE_TELEMETRY>"
}
}
}
}{
"servers": {
"topicforge": {
"type": "stdio",
"command": "uvx",
"args": [
"topicforge==0.11.0"
],
"env": {
"TOPICFORGE_MODE": "<TOPICFORGE_MODE>",
"TOPICFORGE_DDS_BACKEND": "<TOPICFORGE_DDS_BACKEND>",
"TOPICFORGE_DDS_DOMAIN_ID": "<TOPICFORGE_DDS_DOMAIN_ID>",
"TOPICFORGE_TELEMETRY": "<TOPICFORGE_TELEMETRY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
TOPICFORGE_MODEOptional | mock (deterministic fixtures, no ROS2 needed), live, or auto. Defaults to auto. |
TOPICFORGE_DDS_BACKENDOptional | DDS backend: mock, cyclone, or auto. cyclonedds is a core dependency on platforms with wheels (Linux x86_64, Windows x64, macOS; Python 3.10-3.13); the [dds] extra remains an alias. |
TOPICFORGE_DDS_DOMAIN_IDOptional | DDS domain id to observe, 0-232. Joined at startup; changing it requires a restart. |
TOPICFORGE_TELEMETRYOptional | Opt-in anonymous telemetry, off by default. When off, no network code path executes. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.yaniswav/topicforge |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.