# NousResearch/hermes-agent · MCP serve module missing from packaged builds

## Open now

- 2 issues, 0 PRs open on GitHub.
- #14182: tracking: hermes_agent package restructure
- #21691: \[Feature\]: Refactor project into standard Python package structure

A bug where \`hermes mcp serve\` fails with a missing \`mcp_serve\` module on pip-installed and NixOS environments, alongside related fixes to include the module in built wheels and a broader package restructuring effort.

## TL;DR

- 8 member(s): 2 open issue(s), 3 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #35044. Verify it addresses your case.
- **Recommended:** read PR #35044 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `partially_resolved` · deciding PR(s): `pr-35044`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.16`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #14182: tracking: hermes_agent package restructure
- #21691: \[Feature\]: Refactor project into standard Python package structure

## Closed / duplicate issues

- #22110: \[Bug\]: \`hermes mcp serve\` fails to start on NixOS
- #34871: \[Bug\]: \`hermes mcp serve\` crashes with ModuleNotFoundError: No module named 'mcp_serve' on standard pip install
- #36655: MCP server root module should be included in packaged builds

## Prior & competing PRs

- **#35044: fix(packaging): include mcp_serve in py-modules so hermes mcp serve works on pip installs**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `pyproject.toml`
  - fix hunks:
  - `pyproject.toml`

    ```diff
    @@ -210,7 +210,7 @@ hermes-agent = "run_agent:main"
     hermes-acp = "acp_adapter.entry:main"
     
     [tool.setuptools]
    -py-modules = ["run_agent", "model_tools", "toolsets", "batch_runner", "trajectory_compressor", "toolset_distributions", "cli", "hermes_bootstrap", "hermes_constants", "hermes_state", "hermes_time", "hermes_logging", "utils"]
    +py-modules = ["run_agent", "model_tools", "toolsets", "batch_runner", "trajectory_compressor", "toolset_distributions", "cli", "hermes_bootstrap", "hermes_constants", "hermes_state", "hermes_time", "hermes_logging", "utils", "mcp_serve"]
     
     [tool.setuptools.package-data]
     hermes_cli = ["web_dist/**/*", "tui_dist/**/*", "scripts/install.sh", "scripts/install.ps1"]
    ```
- **#39121: fix(mcp): namespace \`mcp_serve\` import in \`mcp_command\` dispatcher**. closed without merge · fix tier `suggested`
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#22148: fix(mcp): include mcp_serve module in built wheel**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#35044`

## Fix status

- Merged to main in PR #35044 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-05-30`.
- Subsystem: `agent`