About MCP Server Runner
An extension for VS Code and Cursor to manage and run MCP servers locally. It saves multiple configurations, controls server startup and shutdown, and displays logs in the editor.
Key features
- 01Save multiple server configurations
- 02Start and stop servers with one click
- 03View logs in the editor
- 04Auto-start servers with VS Code
Use cases
- 01Manage local MCP server configurations
- 02Start or stop servers from the editor
- 03Inspect server logs for troubleshooting
- 04Set servers to launch with VS Code
MCP support
As an MCP server management extension, it configures, starts, and stops local MCP servers and displays their logs; it does not manage remote connections.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMCP Server Runner
A VS Code / Cursor extension for managing and running Model Context Protocol (MCP) servers locally.
Features
- Configure and save multiple MCP server configurations
- Start and stop MCP servers with a single click
- View server logs directly in the editor
- Auto-start servers when VS Code starts
Usage
Adding a Server
- Click the MCP Servers icon in the activity bar
- Click the "+" button or use the command "MCP: Add Server Configuration"
- Enter the server details:
- Name: A friendly name for your server
- Command: The full command to start the server (e.g.,
python -m mcp_server --host 127.0.0.1 --port 8000) - Port: The port number the server will listen on
- Auto-start: Whether to start the server automatically when VS Code starts
Starting a Server
- Click on a server in the MCP Servers view to start it
- Or right-click and select "Start Server"
- Or use the command "MCP: Start Server"
Stopping a Server
- Click on a running server in the MCP Servers view to stop it
- Or right-click and select "Stop Server"
- Or use the command "MCP: Stop Server"
Viewing Logs
- Right-click on a server and select "View Logs"
- Or use the command "MCP: View Server Logs"
Editing a Server
- Right-click on a server and select "Edit Server"
- Or use the command "MCP: Edit Server Configuration"
Deleting a Server
- Right-click on a server and select "Delete Server"
- Or use the command "MCP: Delete Server Configuration"
Requirements
- VS Code 1.80.0 or higher
Extension Settings
This extension contributes the following settings:
mcpServerRunner.servers: List of MCP server configurations
Development
Building the Extension
npm install
npm run compile
Packaging the Extension
npm run package
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.