MCP-Console

# MCP Console <p align="center"> <img src="assets/icon/app_icon.png" alt="MCP Console" width="88" /> </p> <p align="center"> <strong>Centralized management and editing of MCP server settings for multiple AI clients.</strong> </p> <p align="center"> <a href="https://github.com/JiaDians/mcp_console/actions/workflows/ci.yml"><img src="https://github.com/JiaDians/mcp_console/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="https://github.com/JiaDians/mcp_console/releases"><img src="https://img.shields.io/github/v/release/JiaDians/mcp_console?label=release" alt="Release" /></a> <img src="https://img.shields.io/badge/platform-Windows-0078D4" alt="Windows" /> </p> MCP Console is a Flutter application primarily for Windows desktop, which reads MCP configuration files from enabled AI clients, merges servers with the same name into a single list, and provides version checking, connection status, editing, and updating.  ## Features - **Multi-Client Overview**: Centrally manage MCP settings for Codex, Claude Desktop, Cursor, Windsurf, VS Code, and Copilot CLI. - **MCP Dashboard**: Display total MCP count, enabled clients, disabled items, and HTTP/SSE server statistics. - **Version and Connection Check**: Supports npm, PyPI, GitHub release/tag/package.json fallback, and HTTP/SSE connection probing. - **One-Click Update**: Perform `npm`, `uv`, `pip`, or `git pull` based on MCP type, and synchronously update the configuration file version. - **Complete Setting Editing**: Supports stdio `command`, `args`, `env`, and HTTP/SSE `url`, `headers`, `timeout` fields. - **Secure Display of Sensitive Information**: Environment variables and HTTP headers are masked by default, with manual display or copying options. ## Download and Installation Visit [Releases](https://github.com/JiaDians/mcp_console/releases) to download the latest Windows version. | File | Suitable Scenario | | --- | --- | | `MCP_Console_v*_Setup.exe` | Recommended; provides installation process, desktop shortcut, and uninstallation entry | | `MCP_Console_v*_windows_portable.zip` | No installation required; extract and run directly | > [!IMPORTANT] > During the first execution, Windows SmartScreen may display "Windows has protected your computer." This is due to the lack of code signing. If you trust this open-source project, click "More information" → "Run anyway." ## Supported Configuration Sources MCP Console automatically searches for the following default paths and allows custom paths to be added in the settings. | Client | Windows Default Configuration Path | | --- | --- | | Codex | `%USERPROFILE%\.codex\config.toml` | | Claude Desktop | `%APPDATA%\Claude\claude_desktop_config.json` | | Cursor | `%USERPROFILE%\.cursor\mcp.json` | | Windsurf | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` | | VS Code | `%APPDATA%\Code\User\mcp.json` | | Copilot CLI | `%USERPROFILE%\.copilot\mcp-config.json` | > [!NOTE] > MCP name is the primary identifier; MCPs with the same name are considered the same server and displayed together. ## Local Development Requirements: - Flutter 3.x with Windows desktop support enabled - Dart SDK 3.x - Windows 10 / 11 x64 Install dependencies: ```powershell flutter pub get ``` Launch desktop version: ```powershell flutter run -d windows ``` Run analysis and tests: ```powershell flutter analyze --no-fatal-infos flutter test ``` Build release version: ```powershell flutter build windows --release ``` ## Project Structure | Path | Description | | --- | --- | | `lib\ui` | Screens and shared UI components | | `lib\providers` | Riverpod state and data flow | | `lib\services` | Configuration parsing, version checking, local version detection, and update process | | `lib\models` | AI client, MCP server, and version check result models | | `lib\core` | Themes, constants, utilities, and cross-platform paths |