About Gui MCP
Gui MCP is an MCP server published by PhialsBasement in the Developer Tools category: a Blueprint-style visual node editor for creating FastMCP servers. Build MCP tools, resources, and prompts by connecting nodes - no coding required.
The repository has 26 stars and 3 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/PhialsBasement/GUI-MCPThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Gui MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
guiMCP
A Blueprint-style visual node editor for creating FastMCP servers. Build MCP tools, resources, and prompts by connecting nodes - no coding required.
Features
- Visual Node Programming - Unreal Engine Blueprint-style interface with execution flow (white) and data (colored) pins
- Full MCP Support - Create Tools, Resources, and Prompts visually
- Turing Complete - Variables, loops (While, For Each), conditionals (Branch), and all the logic you need
- Live Code Preview - See generated Python code update in real-time as you build
- Simulate Tool Calls - Right-click any tool to test it directly in the editor
- Save/Load Projects - Save your node graphs as
.guimcpfiles - Export to Python - Generate clean, runnable FastMCP server code
Node Categories
| Category | Nodes |
|---|---|
| MCP | Server Config, Tool Definition, Resource Definition, Prompt Definition |
| Flow Control | Return, Branch (If/Else), For Each, While Loop, Sequence |
| Variables | Set Variable, Get Variable, Make Literal |
| Math | Add, Subtract, Multiply, Divide, Modulo |
| Comparison | Equal, Not Equal, Greater Than, Less Than, And, Or, Not |
| String | Format, Concatenate, Length, Split, Join, To String |
| List | Make List, Get, Length, Append, Contains |
| Dictionary | Make Dict, Get, Set, Keys, Values, Has Key |
| I/O | HTTP Request, File Read, File Write, JSON Parse, JSON Stringify |
Installation
# Clone the repository
git clone https://github.com/yourusername/guiMCP.git
cd guiMCP
# Install dependencies
pip install -r requirements.txt
# Run
python main.py
Requirements
- Python 3.11+
- PySide6
- NodeGraphQt
- FastMCP (for running exported servers)
Quick Start
- Add a Server Config node (sets your MCP server name)
- Add a Tool Definition node (defines your tool's name, description, parameters)
- Build your logic using flow control and data nodes
- Add a Return node and connect it to the tool's execution output
- Connect data to the Return node's value input
- Export via File → Export Python (Ctrl+E)
- Run your exported server:
python mcp_server.py
Example
Creating a simple tool that fetches a cat fact:
Tool Definition ("get_cat_fact")
↓ exec
HTTP Request (url: "https://catfact.ninja/fact")
↓ exec ↓ response
Return ←─────────────┘
Generates:
from fastmcp import FastMCP
import urllib.request
import urllib.error
mcp = FastMCP("MyServer")
@mcp.tool
def get_cat_fact() -> str:
"""Fetches a random cat fact"""
_http_url = 'https://catfact.ninja/fact'
# ... HTTP code ...
return http_response
if __name__ == "__main__":
mcp.run()
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Ctrl+N | New Project |
| Ctrl+O | Open Project |
| Ctrl+S | Save Project |
| Ctrl+Shift+S | Save Project As |
| Ctrl+E | Export Python |
| Ctrl+Z | Undo |
| Ctrl+Y | Redo |
| Delete | Delete Selected Nodes |
Project Structure
guiMCP/
├── main.py # Entry point
├── guimcp/
│ ├── core/ # Port types, validation
│ ├── nodes/ # All node definitions
│ │ ├── base/ # ExecutableNode, PureNode, EventNode
│ │ ├── mcp/ # Server, Tool, Resource, Prompt
│ │ ├── flow_control/ # Branch, ForEach, While, Return
│ │ ├── data/ # Math, String, List, Dict operations
│ │ ├── variables/ # Get/Set Variable, Literals
│ │ └── io/ # HTTP, File, JSON operations
│ ├── codegen/ # Code generation
│ └── ui/ # Main window, dialogs, widgets
└── tests/ # Test suite
How It Works
- Execution Pins (white) define the order operations run - connect left to right
- Data Pins (colored) pass values between nodes - colors indicate types
- Event Nodes (Tool/Resource/Prompt Definition) are entry points with only exec_out
- Executable Nodes have exec_in and exec_out, generate statements
- Pure Nodes have no exec pins, generate expressions (evaluated lazily)
License
MIT
README fetched from the repository 4 days ago. The original is authoritative.