Skip to content

(feature) mcp web #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Apr 14, 2025
Merged

(feature) mcp web #42

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
605b49c
initial
f Apr 14, 2025
31123c6
update
f Apr 14, 2025
a04dd1d
web feature
f Apr 14, 2025
87df7c6
update readme
f Apr 14, 2025
7576f01
update readme
f Apr 14, 2025
540d57e
update
f Apr 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/resources/web-interface.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
32 changes: 32 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
- [Output Formats](#output-formats)
- [Commands](#commands)
- [Interactive Shell](#interactive-shell)
- [Web Interface](#web-interface)
- [Project Scaffolding](#project-scaffolding)
- [Server Aliases](#server-aliases)
- [LLM Apps Config Management](#llm-apps-config-management)
Expand Down Expand Up @@ -112,6 +113,7 @@ Available Commands:
get-prompt Get a prompt on the MCP server
read-resource Read a resource on the MCP server
shell Start an interactive shell for MCP commands
web Start a web interface for MCP commands
mock Create a mock MCP server with tools, prompts, and resources
proxy Proxy MCP tool requests to shell scripts
alias Manage MCP server aliases
Expand Down Expand Up @@ -320,6 +322,36 @@ Special Commands:
/q, /quit, exit Exit the shell
```

### Web Interface

MCP Tools provides a web interface for interacting with MCP servers through a browser-based UI:

```bash
# Start a web interface for a filesystem server on default port (41999)
mcp web npx -y @modelcontextprotocol/server-filesystem ~

# Use a custom port
mcp web --port 8080 docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

# Use SSE
mcp web https://ne.tools
```

The web interface includes:

- A sidebar listing all available tools, resources, and prompts
- Form-based and JSON-based parameter editing
- Formatted and raw JSON response views
- Interactive parameter forms automatically generated from tool schemas
- Support for complex parameter types (arrays, objects, nested structures)
- Direct API access for tool calling

Once started, you can access the interface by opening `http://localhost:41999` (or your custom port) in a browser.

<p align="center">
<img src=".github/resources/web-interface.png" alt="MCP Web Interface" width="700">
</p>

### Project Scaffolding

MCP Tools provides a scaffolding feature to quickly create new MCP servers with TypeScript:
Expand Down
1 change: 1 addition & 0 deletions cmd/mcptools/commands/guard.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -165,6 +165,7 @@ func processPatternString(patternsStr string, patternMap map[string][]string) {
patternValue := parts[1]

// Map entity type to known types
//nolint:goconst // Using literals directly for readability
switch entityType {
case "tool", "tools":
patternMap[EntityTypeTool] = append(patternMap[EntityTypeTool], patternValue)
Expand Down
Loading