Skip to content

[v0.8.2] Add filtering positional argument to hatch mcp [discover|show|list] [servers|hosts] commands#52

Merged
LittleCoinCoin merged 2 commits intoCrackingShells:mainfrom
LittleCoinCoin:dev
Apr 2, 2026
Merged

[v0.8.2] Add filtering positional argument to hatch mcp [discover|show|list] [servers|hosts] commands#52
LittleCoinCoin merged 2 commits intoCrackingShells:mainfrom
LittleCoinCoin:dev

Conversation

@LittleCoinCoin
Copy link
Copy Markdown
Member

@LittleCoinCoin LittleCoinCoin commented Apr 2, 2026

Feature

Added filter_name positional argument to MCP discovery and listing commands

Enhanced MCP CLI commands to support optional positional filtering by name. This provides a more intuitive syntax for filtering results compared to flag-based filtering.

Affected Commands

  • hatch mcp discover hosts [filter_name] - Filter by host name
  • hatch mcp list hosts [filter_name] - Filter by host name
  • hatch mcp list servers [filter_name] - Filter by server name
  • hatch mcp show hosts [filter_name] - Filter by host name
  • hatch mcp show servers [filter_name] - Filter by server name

Usage Examples

# Filter hosts by name (positional)
hatch mcp list hosts claude-desktop

# Filter servers by name (positional)
hatch mcp list servers weather-server

# Filter with regex pattern
hatch mcp list servers "^weather.*"

# Combined: positional filter + flag-based filter
hatch mcp list servers weather --host ".*desktop"

Documentation

Updated documentation to reflect new positional argument

  • Updated CLI reference documentation with new syntax and examples
  • Added usage examples for positional filtering
  • Clarified relationship between positional and flag-based filtering
  • Updated command examples throughout documentation

Agent-Id: agent-3e85a26f-f7c9-4ec3-8893-1a050ed9dcbb
Linked-Note-Id: 20e46d61-979f-46f8-a102-49599be121ea
docs: document filter_name parameter for MCP discovery and listing funct
docs: correct MCP command examples and argument order for filters
docs(mcp): document filter_name parameter for discover_servers and list_
docs: correct regex pattern matching to case-sensitive in MCP discovery
docs(mcp): add example for filtering servers by name
docs(mcp): simplify server show command syntax
docs(mcp): correct list servers example to use --host instead of --env-v
docs(mcp): update examples to use sync command for multi-host configurat
docs(mcp): update backup command syntax to remove --host flag and simpli
@LittleCoinCoin LittleCoinCoin merged commit f29393b into CrackingShells:main Apr 2, 2026
1 check passed
cracking-shells-semantic-release bot pushed a commit that referenced this pull request Apr 2, 2026
## <small>0.8.2 (2026-04-02)</small>

* Merge pull request #52 from LittleCoinCoin/dev ([f29393b](f29393b)), closes [#52](#52)
* docs: update to match new positional argument ([893082f](893082f))
* feat(cli): add filter_name positional argument to MCP discovery and list ([847665e](847665e))
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant