Skip to main content
Glama
lightwrath

pi-sylvan

by lightwrath
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

pi-sylvan

A thin Pi package that exposes Sylvan's MCP tools to a Pi coding agent.

Installation

pi install https://github.com/lightwrath/pi-sylvan.git

The package is installed automatically by Sylvan when the PiAgent Space feature is enabled.

Related MCP server: pi-subagent-mcp

Configuration

The default endpoint is:

http://host.containers.internal:4007/api/v1/mcp

Override it when Podman cannot resolve the host alias, or when Sylvan is running elsewhere:

export SYLVAN_MCP_URL=http://192.168.1.10:4007/api/v1/mcp

localhost inside a Space refers to the Space container, not the host. Podman host-gateway mapping, the host LAN address, or host networking are alternatives when host.containers.internal is unavailable.

Sylvan is unauthenticated and intended for a trusted LAN only. Do not expose the MCP endpoint publicly.

Tools

The extension registers:

  • list_spaces

  • create_space

  • list_dev_shells

  • create_dev_shell

  • send_command

Each Pi/MCP session owns only the Developer Shells that it creates. Shell command output is limited to the last 50 KB.

The extension creates its MCP connection lazily and terminates the MCP session during Pi's session_shutdown lifecycle event. A hard process crash can leave the server-side Shells until they exit or Sylvan restarts.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • pi-subagent

    guyiicn
    A
    license
    C
    quality
    B
    maintenance
    Enables MCP hosts to delegate coding tasks to Pi CLI as a programmable sub-agent with session tracking and process management.
    7
    3
    MIT

  • opencode-mcp-bridge

    nmt3325
    A
    license
    Not graded
    quality
    B
    maintenance
    Exposes opencode's coding agent and shell as MCP tools, enabling MCP-only AI clients to execute shell commands, manage files, and run agent sessions with async job handling.
    12 npm
    1
    MIT

  • pi-mcp

    zhaob1n
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server exposing pi coding-agent tools for file and shell operations, including read, write, edit, bash, grep, find, and ls.
    1
    MIT