Files
herolib/examples/mcp/inspector
Mahmoud-Emad 914cba5388 feat: add HTTP/REST transport for MCP servers
- Refactor server to use a generic transport interface
- Add HttpTransport for JSON-RPC and REST over HTTP
- Move existing STDIO logic into a StdioTransport
- Enable dual-mode (STDIO/HTTP) via command-line flags
- Add new examples and docs for HTTP server usage
2025-07-28 13:32:01 +03:00
..

Inspector Example

This is a simple example of how to use the MCP module to create a server that handles JSON-RPC requests and responses.

Usage

import freeflowuniverse.herolib.mcp

// Define custom handlers if needed
handlers := {
    'custom_method': my_custom_handler
}

// Create server configuration
config := mcp.ServerConfiguration{
    // Configure server capabilities as needed
}

// Create and start the server
mut server := mcp.new_server(handlers, config)!
server.start()!

Running Example

  1. bash example.sh
  2. The MCP inspector will open automatically in your browser
  3. The inspector should connect automatically to the V server

Option 2: Manual configuration

  1. Start the MCP inspector: npx @modelcontextprotocol/inspector
  2. Open localhost:5173 in your browser
  3. Configure inspector:
    • Transport type: STDIO
    • Command: <path-to-server.vsh>
    • Arguments: (leave empty)
  4. Click "Connect"

Option 3: Using V directly

  1. Start the MCP inspector: npx @modelcontextprotocol/inspector
  2. Open localhost:5173 in your browser
  3. Configure inspector:
    • Transport type: STDIO
    • Command: v
    • Arguments: run <path-to-server.vsh>
  4. Click "Connect"

Output

Expected output: Inspector Screenshot