shadow-mcp MCP Server

by saagpatel Your server? Claim it

local only

shadow-mcp runs on your own machine — the client starts it, so there is no endpoint to ping. 95 installs a week from pypi. Last commit 13 Oct 2026.

Local MCP server that inventories and risk-grades MCP servers configured on this machine.

Installs per day peak 31 · avg 14 · -17% w/w

a month agotoday

Installs / week

pypi · shadow-mcp

Stars

0 open issues

13 Oct 2026

Last commit

from GitHub

—

License

Python

What the code does

We read the source, 4 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Builds a file path from a variable src/shadow_mcp/collectors/_common.py:29, [пакет] src/shadow_mcp/collectors/_common.py:29

        return os.path.normpath(os.path.join(base_dir, value))

Runs an external command src/shadow_mcp/collectors/claude_cli.py:32, [пакет] src/shadow_mcp/collectors/claude_cli.py:32

        proc = subprocess.run(

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add shadow-mcp -- uvx shadow-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shadow-mcp": {
      "command": "uvx",
      "args": [
        "shadow-mcp"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.shadow-mcp]
command = "uvx"
args = ["shadow-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "shadow-mcp": {
      "command": "uvx",
      "args": [
        "shadow-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "shadow-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shadow-mcp"
      ]
    }
  }
}

Alternatives to shadow-mcp

same job, measured the same way

mcp-audit

by saagpatel

Scan, enumerate, and risk-score every MCP server configured on your machine.

670 installs/wk local only

MCP Kokoro Tts

by mrfqcentic

Local Kokoro-82M TTS MCP server that synthesizes and plays speech on your machine

116 installs/wk local only

Zeroclaw MCP

by zeroclaw-labs

Configure and manage authorized ZeroClaw installations through a local MCP server.

483 installs/wk local only

MCP Anvil

by aiinfradecoded

Local MCP gateway daemon: route, audit, and inspect MCP servers from one config.

161 installs/wk local only

McpMux

by mcpmux

McpMux — configure MCP servers once, connect every AI client through one local gateway.

local only

Registry

by policylayer

The MCP server that vets MCP servers: identity, risk grade and per-tool risk before you install.

5 tools answering

McpMux

by mcpmux

McpMux — configure MCP servers once, connect every AI client through one local gateway.

local only

Hypermarrow MCP

by qianqiuwanzi

Local-first AI memory MCP server. Record, recall and consolidate memory on your own machine.

38 installs/wk local only

shadow-mcp — questions

Answers built from our own checks of this server.

Why is there no uptime for shadow-mcp?

shadow-mcp runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package shadow-mcp was installed 95 times last week.

How do I connect shadow-mcp?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls shadow-mcp straight from pypi; nothing to host, nothing to sign up for.

How many people use shadow-mcp?

The pypi package shadow-mcp was installed 95 times in the last week. Week over week that is -17%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is shadow-mcp open source?

We cannot say either way: written in Python and 0 stars on GitHub, but we could not determine the licence, and without one the code is not open source by default.