AI导哈

MCP服务管理工具

一个仅支持macOS的原生桌面应用，用于统一管理本地MCP服务并控制它们在各个CLI中的启用状态。

  • by HMYDK
  • Swift
  • 本地部署
  • 更新于
在 GitHub 查看 HMYDK/mcp-manager

使用说明

MCP Manager (macOS, SwiftUI)

这是一个仅支持 macOS 的原生桌面应用（SwiftUI），用于统一管理本地 MCP 服务，并控制它们在各 CLI 中的启用状态。

核心能力

  • 只使用官方配置目录（内置锁定）
    • Codex CLI: ~/.codex/config.toml
    • Claude Code (project): <workspace>/.mcp.json
    • Gemini CLI (project): <workspace>/.gemini/settings.json
  • 统一维护 MCP 服务（命令、参数、env、cwd、描述）
  • 矩阵开关控制 MCP x CLI
  • 同步并检测
    • 写入各 CLI 官方配置
    • 检查 CLI 是否安装
    • 检查配置是否与矩阵一致
    • 展示每个 CLI 当前已配置 MCP 与外部已有 MCP

技术栈

  • Swift 6
  • SwiftUI (macOS 14+)
  • 无前端 Web 运行时依赖

仓库约束

  • 当前仓库仅保留 Swift/SwiftUI 的 macOS 原生应用代码。
  • 已移除 Electron / Node.js 渲染层与打包相关文件（如 src/、package.json、package-lock.json）。

运行（推荐）

使用 .app 启动方式，确保窗口以前台 GUI 形式出现：

./scripts/run-macos-app.sh

运行（开发）

swift build
swift run MCPManagerMac

说明：swift run 在某些终端上下文会被 LaunchServices 识别为后台进程（BackgroundOnly），导致“进程在跑但看不到窗口”。推荐始终使用 run-macos-app.sh 启动。

目录结构

  • Package.swift
  • Sources/MCPManagerMac/
    • MCPManagerMacApp.swift
    • Models.swift
    • Services/
    • ViewModels/
    • Views/

状态文件

默认路径：

  • ~/.mcp-manager/state.json

若 home 不可写，会回退到：

  • <workspace>/.mcp-manager-data/state.json

相关 MCP