Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Links Service

FreeNot checked

Fleet launcher for local webapps and container links: list, status-check, launch and stop registered services by port. FastMCP server.

GitHubEmbed

About

Fleet launcher for local webapps and container links: list, status-check, launch and stop registered services by port. FastMCP server.

README

version python fastmcp platform license

Ask Claude which of your local webapps are up, then start or stop them without leaving the chat.

What You Can Do

How it runs: a stdio MCP server that reads two JSON registries (webapps and containers), probes each webapp's TCP port on 127.0.0.1, and launches or stops processes on your machine. It does not bundle or host any of the webapps it manages.

  • List every registered webapp with a live Running / Disconnected status
  • List registered container links
  • Launch a webapp using its registered start command and working directory
  • Stop a webapp by terminating the process listening on its registered port
  • Inspect one webapp: status, PID, CPU and memory of the listening process

Quick Install

Current limitation: registry paths are hardcoded to D:/Dev/repos/mcp-central-docs/docs/operations/ (webapp-registry.json, container-registry.json). Without those files every tool returns an empty list or a "Registry not found" error. Making the paths configurable is open work.

git clone https://github.com/sandraschi/mcp-links-service
cd mcp-links-service
uv sync

Then add it to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-links-service": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\mcp-links-service", "run", "mcp-links-service"]
    }
  }
}

Restart Claude Desktop. A native/ Tauri shell and an mcpb/ bundle exist in the repo but are not yet documented here.

Example Prompts

  • "Which of my webapps are running right now?"
  • "Start the plex webapp and tell me when it's up"
  • "Stop whatever is listening for the nekomimi dashboard and show me its memory use first"

Tools

Tool Purpose
list_webapps All registered webapps with live port status
list_containers All registered container links
get_webapp_status Status, PID, CPU and memory for one webapp
launch_webapp Run the registered start command (no-op if the port is already open)
stop_webapp Terminate the process on the webapp's port

stop_webapp ends whatever process owns the port, and launch_webapp runs a shell command taken from the registry, so keep the registry files trusted.

Requirements

Windows 10/11, Python 3.12+ via uv (winget install astral-sh.uv), and the two registry JSON files described above.

Development

uv sync
uv run ruff check .

There is no test suite yet.

License

MIT

from github.com/sandraschi/mcp-links-service

Install Links Service in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install links-service

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add links-service -- uvx --from git+https://github.com/sandraschi/mcp-links-service mcp-links-service

Step-by-step: how to install Links Service

FAQ

Is Links Service MCP free?

Yes, Links Service MCP is free — one-click install via Unyly at no cost.

Does Links Service need an API key?

No, Links Service runs without API keys or environment variables.

Is Links Service hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Links Service in Claude Desktop, Claude Code or Cursor?

Open Links Service on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Links Service with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs