Skip to content

Commit c0eebb3

Browse files
authored
Add warning about MCP server default arguments (#152)
Signed-off-by: Dan Barr <[email protected]> Co-authored-by: Dan Barr <[email protected]>
1 parent cad6aba commit c0eebb3

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/toolhive/guides-cli/run-mcp-servers.mdx

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,24 @@ thv run my-mcp-server:latest -- --arg1 value1 --arg2 value2
150150

151151
Check the MCP server's documentation for the required arguments.
152152

153+
:::warning
154+
155+
Some MCP servers in the ToolHive registry include default arguments that are
156+
essential for proper operation. When you provide custom arguments using
157+
`-- <ARGS>`, these replace the registry defaults entirely rather than adding to
158+
them.
159+
160+
Before adding custom arguments, check the server's registry entry:
161+
162+
```bash
163+
thv registry info <SERVER> --format json | jq '.args'
164+
```
165+
166+
If default arguments are listed, include them along with your custom arguments
167+
to ensure the server functions correctly.
168+
169+
:::
170+
153171
### Run a server on a specific port
154172

155173
ToolHive creates a reverse proxy on a random port that forwards requests to the

0 commit comments

Comments
 (0)