diff --git a/README.md b/README.md index ef5abcf..8660501 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,10 @@ Contributing
+ + +https://github.com/user-attachments/assets/474206f9-4a88-43d0-b4f3-3e7cfe2d743d + ## Introduction Model Context Shell lets AI agents compose [MCP](https://modelcontextprotocol.io/) tool calls using something like Unix shell scripting. Instead of the agent orchestrating each tool call individually (loading all intermediate data into context), it can express a workflow as a pipeline that executes server-side. @@ -172,6 +176,14 @@ thv run --secret github,target=GITHUB_PERSONAL_ACCESS_TOKEN github See the [ToolHive documentation](https://docs.stacklok.com/toolhive) for the full guide, including [CLI quickstart](https://docs.stacklok.com/toolhive/tutorials/quickstart-cli) and [available integrations](https://docs.stacklok.com/toolhive/integrations). +### Testing with the ToolHive Playground + +The ToolHive desktop app has a built-in [Playground](https://docs.stacklok.com/toolhive/guides-ui/playground) that lets you test MCP servers interactively without setting up an external AI client. You pick a model provider, enable the servers you want to test, and chat with the model to see how it uses the tools. Every tool call is logged with parameters, results, and response time, which makes it easy to debug pipelines. + +The [demo video](#demo-video) at the top of this README shows Model Context Shell being tested this way. + +See the [ToolHive UI guide](https://docs.stacklok.com/toolhive/guides-ui/) for more on the desktop app. + ### Tips **Connect only Model Context Shell to your agent.** Don't connect individual MCP servers directly to the agent alongside Model Context Shell. When agents have direct access to tools, they tend to call them individually instead of composing pipelines. The server can access all your MCP servers through ToolHive automatically. diff --git a/demo.mp4 b/demo.mp4 new file mode 100644 index 0000000..b1e8742 Binary files /dev/null and b/demo.mp4 differ