From f27aa3a925e64f3c67ae53bd0e3ac03ed0d5bf76 Mon Sep 17 00:00:00 2001 From: Dan Barr <6922515+danbarr@users.noreply.github.com> Date: Tue, 2 Sep 2025 15:29:07 -0400 Subject: [PATCH] Add warning about MCP server default arguments Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com> --- docs/toolhive/guides-cli/run-mcp-servers.mdx | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/toolhive/guides-cli/run-mcp-servers.mdx b/docs/toolhive/guides-cli/run-mcp-servers.mdx index d3311cf6..f5385230 100644 --- a/docs/toolhive/guides-cli/run-mcp-servers.mdx +++ b/docs/toolhive/guides-cli/run-mcp-servers.mdx @@ -150,6 +150,24 @@ thv run my-mcp-server:latest -- --arg1 value1 --arg2 value2 Check the MCP server's documentation for the required arguments. +:::warning + +Some MCP servers in the ToolHive registry include default arguments that are +essential for proper operation. When you provide custom arguments using +`-- `, these replace the registry defaults entirely rather than adding to +them. + +Before adding custom arguments, check the server's registry entry: + +```bash +thv registry info --format json | jq '.args' +``` + +If default arguments are listed, include them along with your custom arguments +to ensure the server functions correctly. + +::: + ### Run a server on a specific port ToolHive creates a reverse proxy on a random port that forwards requests to the