Skip to content

Commit 6c381d1

Browse files
docs(guide): add viewing host configurations section
Update MCP Host Configuration guide with current command syntax. Changes: - Add "Viewing Host Configurations" section with list/show commands - Document table views vs detailed views - Add filtering examples with regex patterns Addresses command documentation gaps identified in R16 v1 section 4. All commands verified against implementation (R17).
1 parent 59b2485 commit 6c381d1

1 file changed

Lines changed: 39 additions & 0 deletions

File tree

docs/articles/users/MCPHostConfiguration.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,45 @@ hatch mcp list servers
6868
hatch mcp list servers --env-var production
6969
```
7070

71+
### Viewing Host Configurations
72+
73+
Hatch provides multiple ways to view MCP host configurations:
74+
75+
**Table Views** (for quick overview):
76+
- `hatch mcp list hosts`: View all hosts and their servers
77+
- `hatch mcp list servers`: View all servers and their hosts
78+
79+
**Detailed Views** (for comprehensive information):
80+
- `hatch mcp show hosts`: Detailed view of all host configurations
81+
- `hatch mcp show servers`: Detailed view of all server configurations
82+
83+
**Filtering**:
84+
All commands support regex filtering:
85+
- `hatch mcp list hosts --server "weather.*"`: Show only servers matching pattern
86+
- `hatch mcp show servers --host "claude.*"`: Show only hosts matching pattern
87+
88+
**Examples**:
89+
90+
```bash
91+
# View all hosts with their servers (table view)
92+
hatch mcp list hosts
93+
94+
# View all servers with their hosts (table view)
95+
hatch mcp list servers
96+
97+
# View detailed host configurations
98+
hatch mcp show hosts
99+
100+
# View detailed server configurations
101+
hatch mcp show servers
102+
103+
# Filter by server name using regex
104+
hatch mcp show hosts --server "weather.*"
105+
106+
# Filter by host name using regex
107+
hatch mcp show servers --host "claude.*"
108+
```
109+
71110
### Remove a Server
72111

73112
Remove an MCP server from a host:

0 commit comments

Comments
 (0)