ctrlpi avatar

Pi Bay

ctrlpi/pi-bay

App and MCP server for Raspberry Pis and SSH devices on a LAN: files, terminal, ctrlPi API install.

GitHub stars
1
tools
12
transport
STDIO
last updated
Nov 8, 2026

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

pi_devices_listList discovered devices on the LAN with model, ctrlPi status, and saved credential availability.

List discovered devices on the LAN with model, ctrlPi status, and saved credential availability.

No parameter schema in public metadata yet.

pi_device_infoGet hardware model, OS, kernel, storage, memory, uptime, and ctrlPi details.

Get hardware model, OS, kernel, storage, memory, uptime, and ctrlPi details.

No parameter schema in public metadata yet.

pi_device_authenticateSign in over SSH and optionally save the password to the system keychain.

Sign in over SSH and optionally save the password to the system keychain.

No parameter schema in public metadata yet.

pi_command_runRun a shell command and return its output and exit code, with a timeout (default 30 s, max 5 min).

Run a shell command and return its output and exit code, with a timeout (default 30 s, max 5 min).

No parameter schema in public metadata yet.

pi_files_listList one folder relative to $HOME, optionally with hidden files.

List one folder relative to $HOME, optionally with hidden files.

No parameter schema in public metadata yet.

pi_file_readRead a file as UTF-8 text or base64.

Read a file as UTF-8 text or base64.

No parameter schema in public metadata yet.

pi_file_writeCreate or overwrite a UTF-8 or base64 file, up to 16 MB, creating missing parent folders.

Create or overwrite a UTF-8 or base64 file, up to 16 MB, creating missing parent folders.

No parameter schema in public metadata yet.

pi_directory_createCreate a folder relative to $HOME.

Create a folder relative to $HOME.

No parameter schema in public metadata yet.

pi_path_renameRename or move a file or folder relative to $HOME.

Rename or move a file or folder relative to $HOME.

No parameter schema in public metadata yet.

pi_path_deletePermanently delete a file or recursively delete a folder relative to $HOME.

Permanently delete a file or recursively delete a folder relative to $HOME.

No parameter schema in public metadata yet.

pi_device_rebootReboot the device.

Reboot the device.

No parameter schema in public metadata yet.

pi_ctrlpi_installInstall or update the ctrlPi API (pi-gpio-api), and start its service when sudo needs no password.

Install or update the ctrlPi API (pi-gpio-api), and start its service when sudo needs no password.

No parameter schema in public metadata yet.

Sponsors

Readme

Pi Bay

Platform: Cross-Platform Version 0.9.34 Node 20+ Protocol: MCP Tools: 12 License: MIT Status: Beta Build Status

pi-bay is an App and MCP Server for managing Raspberry Pis and other SSH devices on a LAN: find them, browse and edit their files, and run commands in an SSH terminal.

Quick start

Requires Node.js 20 or newer and SSH enabled on the target device.

npx @ctrlpi/pi-bay

View the full README on GitHub

Details

Repository
github.com/ctrlpi/pi-bay
Category
Developer Tools
Package
@ctrlpi/pi-bay
Transport
STDIO
Registry
MCP registry, active

More from ctrlpi

Related Developer Tools MCP servers

View all
1frankxmx avatarDailyhotmcpfrankxmx/dailyhotmcp聚合55+平台热门榜单数据的AI工具,支持微博、知乎、B站、GitHub等平台。适用于LLM/RAG场景。1stars
2greenmtnsun avatarGitEasy MCPgreenmtnsun/giteasyPlain-English git for agents: 22 tools to branch, commit, push and tag. Free tier.1stars
32648782102 avatarProofpack2648782102/proofpack-cliLocal, read-only acceptance reports for AI-assisted Git changes, exposed as one MCP tool.1stars
4tencent-lexiang avatarDEPRECATED - Use lexiang-mcp-servertencent-lexiang/lexiang-mcp-serverDEPRECATED: Please use io.github.tencent-lexiang/lexiang-mcp-server instead.1stars
5jcislo avatarMoltalyzer Mcpjcislo/moltalyzer-mcpPolymarket prediction-market intelligence + AI, GitHub & narrative feeds for agents, via x402.1stars
6malkreide avatarHn Tech Signal Mcpmalkreide/hn-tech-signal-mcpMCP server for tech & AI signal intelligence: HackerNews, arXiv, Lobste.rs and GitHub1stars