MCP Servers Viewer

Sidebar viewer for Cursor (and VS Code-compatible) MCP servers.

Shows live status from your local Cursor runtime:

• Connected (N tools) — green check
• Error — red error
• Needs auth — key icon
• Not connected / disabled

Expand a connected server to see its tools.

Features

• Activity Bar panel MCP Servers Viewer
• Same list in the Explorer sidebar
• Reads config from both ~/.cursor/mcp.json (global) and .cursor/mcp.json (project-level)
• When servers exist in both configs, they are grouped under Global / Project headers
• Supports JSONC — comments (// and /* */) in config files are handled correctly
• Shows a warning in the tree if a config file has syntax errors (click to open & fix)
• Reads live status from ~/.cursor/projects/<workspace>/mcps/
• Auto-refresh of the view every 5 seconds
• Refresh really reconnects: the toolbar refresh button reconnects every server
• Per-server reconnect: hover a server row and click the sync icon

Config sources

If both files contain servers, the tree shows two collapsible groups so you can tell at a glance where each server is defined. If only one file has servers, the list stays flat (no extra nesting).

Reconnecting servers

The refresh button does not just repaint the list — it forces Cursor to drop and re-establish the MCP connections, which is what you usually want when a server sits in Error and reloading the window is too heavy a hammer.

Cursor exposes no extension API for reconnecting an MCP server, so this works by touching the server entry in the corresponding mcp.json: Cursor watches that file and reloads any server whose effective config changed. The extension writes a small nonce value for that purpose — MCP_VIEWER_RECONNECT in env for stdio servers, X-Mcp-Viewer-Reconnect in headers for http/sse servers — and bumps it on every reconnect.

Two consequences worth knowing:

• The nonce stays in your config between reconnects. It is inert: stdio servers just receive one extra environment variable, remote servers one extra header.
• The first reconnect rewrites mcp.json in canonical 2-space JSON, so inline arrays get expanded. Your settings are preserved; only formatting may change.

Servers marked "disabled": true are skipped, and a config that fails to parse is left untouched with an error shown instead.

Install

From Marketplace

Search for MCP Servers Viewer by Oleh Popkov, or install:

cursor --install-extension OlehPopkov.mcp-servers-viewer

From VSIX

cursor --install-extension mcp-servers-viewer-0.3.0.vsix

Then reload the window.

From source

npm install
npx vsce package
cursor --install-extension ./mcp-servers-viewer-0.3.0.vsix

Commands

• MCP Servers Viewer: Refresh (Reconnect All Servers)
• MCP Servers Viewer: Reconnect Server — pick one server from a list
• MCP Servers Viewer: Refresh View Only — repaint without reconnecting
• MCP Servers Viewer: Open
• MCP Servers Viewer: Open MCP Config

Requirements

• Cursor with MCP configured in ~/.cursor/mcp.json or <workspace>/.cursor/mcp.json
• Works best when the workspace has a matching folder under ~/.cursor/projects/

Support / Donations

If this extension helps you, donations are welcome:

License

MIT