openroland-mcp-core

Shared Python library for local MCP server hosting.

Features

• Transport-neutral McpServerDefinition registry (entry points + TOML).
• STDIO runner for agent clients (run_stdio, stderr-only logs).
• Local HTTP host on 127.0.0.1:3333 with per-server Streamable HTTP mounts.
• HTML dashboard at / and health routes.
• Windows system tray (openroland-mcp-host) with one icon for all servers.
• Per-server nested tray submenus, start/stop/restart, endpoint copy.
• Host tray actions: logs folder, config folder, start with Windows, LAN toggle (with warning), about, quit.
• Windows single-instance mutex and POST /_host/activate for second launches.
• Generic tkinter credential forms (no secrets on stdout).
• Local origin validation on HTTP when LAN access is disabled.

Install

pip install openroland-mcp-core[http,windows-tray]

STDIO (single server)

from openroland_mcp_core.mcp.stdio import run_stdio

run_stdio(definition, config)

Windows tray host

openroland-mcp-host

From baseroot after make init:

make mcp-host
make forgejo-mcp-tray FORGEJO_MCP_CONFIG=D:/path/to/manifest.json

Host config: %APPDATA%\OpenRoLandMcpHost\config.toml

Logs: %LOCALAPPDATA%\OpenRoLandMcpHost\logs\

Register a server package

[project.entry-points."advpy.mcp_servers"]
my-server = "my_package.mcp_definition:create"

The callable must return an McpServerDefinition.

Cursor (HTTP)

Start the tray host first, then point Cursor at:

http://127.0.0.1:3333/servers/<server-id>/mcp

Example ~/.cursor/mcp.json:

{
  "mcpServers": {
    "forgejo-actions": {
      "url": "http://127.0.0.1:3333/servers/forgejo-actions/mcp"
    }
  }
}

Do not put API tokens in mcp.json; use the tray Set Credentials... action or environment variables read by the server package.