This release simplifies the default local setup flow for Seiro MCP. It focuses the supported runtime on local stdio, removes the previous token/TCP startup path from the normal workflow, and adds CLI helpers so users no longer need to manually discover binary paths or write the project config from scratch.
Highlights
- Added
seiro-mcp config mcpto print a paste-ready Codex MCP registration snippet. - Added
seiro-mcp config projectto create a minimal project-localseiro-mcp.toml. - Changed the default project config file from
config.tomltoseiro-mcp.tomlto avoid collisions with other tools. - Removed token setup from the default local workflow;
MCP_SHARED_TOKENis no longer required for stdio startup. - Removed TCP transport from the supported runtime for now; Seiro MCP now uses local
stdiostartup as the normal supported mode. - Added
seiro-mcp skill installas the default bundled skill install command. It installsseiro-mcp-visionos-build-operatorwhen no skill name is provided. - Updated README, quickstart, runbook, compatibility, config, glossary, and manual test documentation for the simplified setup flow.
- Documented that TCP is no longer part of the supported local workflow and should return only as a separately designed remote/server mode.
Installation Notes
Install or upgrade the binary:
cargo install seiro-mcp --locked --force --version 0.5.0Generate the Codex-side MCP registration snippet:
seiro-mcp config mcpPaste the output into Codex config (~/.codex/config.toml):
[mcp_servers.seiro_mcp]
command = "/Users/<user>/.cargo/bin/seiro-mcp"Then create the project-local config from the target project root:
seiro-mcp config projectThis creates:
[visionos]
allowed_paths = []
allowed_schemes = []
xcode_path = "/Applications/Xcode.app/Contents/Developer"To install the bundled Codex skill:
seiro-mcp skill installThe explicit command remains supported for compatibility:
seiro-mcp skill install seiro-mcp-visionos-build-operatorMigration Notes
If your project currently has a Seiro MCP config.toml, rename or copy that project-specific content to seiro-mcp.toml.
mv config.toml seiro-mcp.tomlDo not rename Codex's ~/.codex/config.toml; that file remains the Codex-side MCP registration file.
The default local workflow no longer needs:
MCP_SHARED_TOKEN--transport--tokenworking_directoryMCP_CONFIG_PATH
MCP_CONFIG_PATH and --config are still available for non-default config locations.
Compatibility Notes
- MCP tool contracts are unchanged.
- The supported local runtime is now stdio-only.
- TCP, WebSocket, and other remote transports are not currently supported.
- If TCP is reintroduced later, it should be designed as a separate remote/server mode with explicit bind, authentication, exposure, Inspector, and migration guidance.
- Skill-only installation still requires a separate Seiro MCP binary install and MCP client configuration.
Verification
cargo fmt -- --checkcargo checkcargo test --allcargo run -p xtask -- check-docs-linkscargo run -p xtask -- docs-langscancargo run -- skill install --help
Full Changelog: v0.4.0...v0.5.0