MCP Server Manager for VS Code

A comprehensive VS Code extension for managing local Model Context Protocol (MCP) servers. Easily configure, monitor, and control MCP servers directly within VS Code.

Features

Server Management

• Add/Edit/Remove MCP servers with an intuitive interface
• Start/Stop/Restart servers with a single click
• Auto-start servers on VS Code startup
• Server status monitoring with real-time updates
• Environment variables and working directory configuration

Dashboard & Monitoring

• Sidebar tree view showing all configured servers and their status
• WebView dashboard with detailed server information and controls
• Status bar integration displaying active server count
• Real-time logs for each server with dedicated output channels
• Server uptime tracking and error reporting

AI Integration

• MCP Definition Provider for VS Code's language model integration
• Automatically expose running MCP servers to GitHub Copilot and other AI assistants
• Seamless integration with VS Code's AI features

Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "MCP Server Manager"
4. Click Install

From Source

git clone <repository-url>
cd VSCodeExt
npm install
npm run compile
# Press F5 to run in debug mode

Usage

Adding a Server

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Type "MCP: Add Server"
3. Fill in the server details:
   • Name: A friendly name for your server
   • Command: The command to start the server (e.g., python, node, npx)
   • Args: Command line arguments (space-separated)
   • Working Directory: Optional working directory for the server
   • Auto-start: Whether to start the server automatically on VS Code startup

Managing Servers

Via Sidebar:

• Click the MCP icon in the Activity Bar
• Right-click on a server for context menu options
• Use the toolbar buttons for quick actions

Via Dashboard:

• Click "MCP" in the status bar to open the dashboard
• View detailed server information
• Control servers with action buttons
• View real-time logs

Via Commands:

• MCP: Add Server - Add a new server
• MCP: Start Server - Start a stopped server
• MCP: Stop Server - Stop a running server
• MCP: Restart Server - Restart a server
• MCP: Remove Server - Remove a server configuration
• MCP: Show Logs - Show server logs
• MCP: Refresh - Refresh server list

Configuration

Servers are stored in VS Code's settings under mcpManager.servers. You can also edit them manually in settings.json:

{
  "mcpManager.servers": [
    {
      "id": "server_1234567890",
      "name": "My MCP Server",
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "cwd": "/path/to/server",
      "autoStart": true,
      "env": {
        "API_KEY": "your-key"
      }
    }
  ]
}

Requirements

• VS Code 1.95.0 or higher
• Node.js runtime (for JavaScript/TypeScript-based MCP servers)
• Python runtime (for Python-based MCP servers)
• Or any other runtime required by your specific MCP servers

Extension Settings

This extension contributes the following settings:

• mcpManager.servers: Array of configured MCP servers

Known Issues

• Server logs are currently kept in memory; very verbose servers may consume more resources
• Environment variable substitution (e.g., $HOME) is not yet supported in paths

Troubleshooting

Server Won't Start

1. Check the logs: Right-click server → "Show Logs"
2. Verify the command and arguments are correct
3. Ensure the working directory exists and is accessible
4. Check environment variables are properly set

Server Keeps Crashing

1. Review the error logs for details
2. Test the command manually in a terminal
3. Check for missing dependencies or incorrect paths
4. Verify file permissions on the server executable

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Release Notes

1.0.0

Initial release of MCP Server Manager

Features:

• Server configuration and management
• Real-time monitoring and status tracking
• Sidebar tree view and WebView dashboard
• Status bar integration
• MCP Definition Provider for AI integration
• Auto-start capability
• Comprehensive logging

License

MIT License

Enjoy managing your MCP servers! 🚀