cli/docs/framework/mcp.md

MCP Service

The MCP service (pkg/mcp) implements the Model Context Protocol, enabling AI assistants like Claude to interact with your application.

Overview

MCP provides a standardized way for AI tools to:

• Execute operations in your application
• Query application state
• Interact with the UI
• Manage files and processes

Basic Setup

import "github.com/Snider/Core/pkg/mcp"

// Create standalone MCP server
mcpService := mcp.NewStandaloneWithPort(9877)

// Or integrate with Core
c, _ := core.New(
    core.WithService(mcp.NewService),
)

Available Tools

The MCP service exposes numerous tools organized by category:

File Operations

Tool	Description
file_read	Read file contents
file_write	Write content to file
file_edit	Replace text in file
file_delete	Delete a file
file_exists	Check if file exists
dir_list	List directory contents
dir_create	Create directory

Window Control

Tool	Description
window_list	List all windows
window_create	Create new window
window_close	Close window
window_position	Move window
window_size	Resize window
window_maximize	Maximize window
window_minimize	Minimize window
window_focus	Bring to front

WebView Interaction

Tool	Description
webview_eval	Execute JavaScript
webview_click	Click element
webview_type	Type into element
webview_screenshot	Capture page
webview_navigate	Navigate to URL
webview_console	Get console logs

Process Management

Tool	Description
process_start	Start a process
process_stop	Stop a process
process_list	List running processes
process_output	Get process output

HTTP API

The MCP service exposes an HTTP API:

# Health check
curl http://localhost:9877/health

# List available tools
curl http://localhost:9877/mcp/tools

# Call a tool
curl -X POST http://localhost:9877/mcp/call \
  -H "Content-Type: application/json" \
  -d '{"tool": "window_list", "params": {}}'

WebSocket Events

Connect to /events for real-time updates:

const ws = new WebSocket('ws://localhost:9877/events');
ws.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log('Event:', data.type, data.data);
};

Integration with Display Service

mcpService := mcp.NewStandaloneWithPort(9877)
mcpService.SetDisplay(displayService)
mcpService.SetWebView(webviewService)

Example: Claude Integration

When Claude connects via MCP, it can:

User: "Move the settings window to the left side of the screen"

Claude uses: window_position("settings", 0, 100)

User: "Take a screenshot of the app"

Claude uses: webview_screenshot("main")

User: "Click the submit button"

Claude uses: webview_click("main", "#submit-btn")

Security Considerations

• MCP server binds to localhost by default
• No authentication (designed for local AI assistants)
• Consider firewall rules for production

Configuration

// Custom port
mcp.NewStandaloneWithPort(8080)

// With all services
bridge := NewMCPBridge(9877, displayService)
bridge.SetWebView(webviewService)