{"repo":"NousResearch/hermes-agent","public_id":"14182","display_label":"MCP serve module missing from packaged builds","summary":"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.","subsystem":"agent","counts":{"members":8,"open_issues":2,"open_issues_distinct":2,"open_prs":0,"closed_issues":3,"merged_prs":1,"attempt_prs":2},"landed_fix":{"status":"merged_to_main","basis":"structural","pr":35044},"resolution":{"state":"partially_resolved","by":"pr-35044"},"freshness":{"state":"verified","last_verified_at":"2026-05-30T08:45:31+00:00","is_stale":false},"grouping":{"backbone":"STRUCTURAL_PARTIAL","link_density":0.15857142857142856},"fix_edges":[{"issue_number":34871,"pr_number":35044,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true}],"members":[{"kind":"issue","number":14182,"title":"tracking: hermes_agent package restructure","url":null,"state":"open"},{"kind":"issue","number":21691,"title":"[Feature]: Refactor project into standard Python package structure","url":null,"state":"open"},{"kind":"issue","number":22110,"title":"[Bug]: `hermes mcp serve` fails to start on NixOS","url":null,"state":"closed"},{"kind":"issue","number":34871,"title":"[Bug]: `hermes mcp serve` crashes with ModuleNotFoundError: No module named 'mcp_serve' on standard pip install","url":null,"state":"closed"},{"kind":"issue","number":36655,"title":"MCP server root module should be included in packaged builds","url":null,"state":"closed"},{"kind":"pr","number":22148,"title":"fix(mcp): include mcp_serve module in built wheel","url":null,"state":"closed","close_reason":{"refs":[{"kind":"pr","value":"#35044","number":35044}],"category":"duplicate_of","implication":"duplicate"},"merged":false},{"kind":"pr","number":35044,"title":"fix(packaging): include mcp_serve in py-modules so hermes mcp serve works on pip installs","url":null,"state":"merged","close_reason":{"category":"merged","implication":"superseded"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["pyproject.toml"],"fix_hunks":[{"file":"pyproject.toml","hunks":["@@ -210,7 +210,7 @@ hermes-agent = \"run_agent:main\"\n hermes-acp = \"acp_adapter.entry:main\"\n \n [tool.setuptools]\n-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\"]\n+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\"]\n \n [tool.setuptools.package-data]\n hermes_cli = [\"web_dist/**/*\", \"tui_dist/**/*\", \"scripts/install.sh\", \"scripts/install.ps1\"]\n"]}]},{"kind":"pr","number":39121,"title":"fix(mcp): namespace `mcp_serve` import in `mcp_command` dispatcher","url":null,"state":"closed","close_reason":{"category":"uncategorized","implication":"needs_llm"},"merged":false,"is_fix_pr":true,"fix_tier":"suggested","fix_detail_withheld":true}],"trust":{"default_tier":"verified","includes_suggested":false}}