Skip to content

Commit a098c75

Browse files
authored
Merge pull request #42 from f/feature/web
(feature) `mcp web`
2 parents 6756fa4 + 540d57e commit a098c75

File tree

6 files changed

+1340
-0
lines changed

6 files changed

+1340
-0
lines changed
666 KB
Loading

README.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@
2828
- [Output Formats](#output-formats)
2929
- [Commands](#commands)
3030
- [Interactive Shell](#interactive-shell)
31+
- [Web Interface](#web-interface)
3132
- [Project Scaffolding](#project-scaffolding)
3233
- [Server Aliases](#server-aliases)
3334
- [LLM Apps Config Management](#llm-apps-config-management)
@@ -112,6 +113,7 @@ Available Commands:
112113
get-prompt Get a prompt on the MCP server
113114
read-resource Read a resource on the MCP server
114115
shell Start an interactive shell for MCP commands
116+
web Start a web interface for MCP commands
115117
mock Create a mock MCP server with tools, prompts, and resources
116118
proxy Proxy MCP tool requests to shell scripts
117119
alias Manage MCP server aliases
@@ -320,6 +322,36 @@ Special Commands:
320322
/q, /quit, exit Exit the shell
321323
```
322324

325+
### Web Interface
326+
327+
MCP Tools provides a web interface for interacting with MCP servers through a browser-based UI:
328+
329+
```bash
330+
# Start a web interface for a filesystem server on default port (41999)
331+
mcp web npx -y @modelcontextprotocol/server-filesystem ~
332+
333+
# Use a custom port
334+
mcp web --port 8080 docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
335+
336+
# Use SSE
337+
mcp web https://ne.tools
338+
```
339+
340+
The web interface includes:
341+
342+
- A sidebar listing all available tools, resources, and prompts
343+
- Form-based and JSON-based parameter editing
344+
- Formatted and raw JSON response views
345+
- Interactive parameter forms automatically generated from tool schemas
346+
- Support for complex parameter types (arrays, objects, nested structures)
347+
- Direct API access for tool calling
348+
349+
Once started, you can access the interface by opening `http://localhost:41999` (or your custom port) in a browser.
350+
351+
<p align="center">
352+
<img src=".github/resources/web-interface.png" alt="MCP Web Interface" width="700">
353+
</p>
354+
323355
### Project Scaffolding
324356

325357
MCP Tools provides a scaffolding feature to quickly create new MCP servers with TypeScript:

cmd/mcptools/commands/guard.go

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,7 @@ func processPatternString(patternsStr string, patternMap map[string][]string) {
165165
patternValue := parts[1]
166166

167167
// Map entity type to known types
168+
//nolint:goconst // Using literals directly for readability
168169
switch entityType {
169170
case "tool", "tools":
170171
patternMap[EntityTypeTool] = append(patternMap[EntityTypeTool], patternValue)

0 commit comments

Comments
 (0)