mseep (Resistance Is Useless)

mseep

一个快速的CLI/TUI，用于从单个规范配置管理所有AI工具中的MCP（模型上下文协议）服务器。在一个地方切换服务器、切换配置文件、运行健康检查和浏览市场。

特性

• 统一配置 --管理MCP服务器一次，同步到所有客户端
• Icloud同步 --在所有Mac上同步您的配置
• 切换开关 --使用视觉反馈启用/禁用服务器
• 快速配置文件 --按1-9可立即切换服务器配置文件
• 导入现有 --从当前客户端配置中发现和导入服务器
• 安全合并 --从不接触不由mseep管理的服务器

支持的客户

所有路径都是平台感知的（macOS、Linux、Windows）。

安装

使用go install（推荐）

go install github.com/ResistanceIsUseless/mseep/cmd/mseep@latest

来源

git clone https://github.com/ResistanceIsUseless/mseep
cd mseep
go build ./cmd/mseep
./mseep --help

快速开始

# Import existing MCP servers from your clients
mseep import --dry-run    # preview what would be imported
mseep import              # import all discovered servers

# Enable iCloud sync (macOS)
mseep sync enable

# Launch the TUI
mseep tui

文本用户界面

mseep tui

┌─────────────────────────────────────────────────────────────────┐
│  mseep                                          Mode: BASIC     │
├─────────────────────────────────────────────────────────────────┤
│  Servers │ Profiles │ Status │ Health │ Apply │ Marketplace    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [ON ]  burp                                         stdio      │
│         Burp Suite MCP proxy for web security testing           │
│         security, web                                           │
│                                                                 │
│  [OFF]  kubernetes                                   stdio      │
│         Kubernetes cluster management via MCP                   │
│         devops, k8s                                             │
│                                                                 │
│  [OFF]  playwright                                   stdio      │
│         Browser automation with Playwright                      │
│         automation, browser                                     │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│ 📦 1/10 enabled · space: toggle · a: apply · 1:automation ...   │
└─────────────────────────────────────────────────────────────────┘

按键绑定

标签页

CLI参考

# Server management
mseep servers list                    # list all servers with status
mseep servers add myserver            # add a new server interactively
mseep servers show burp               # show server details
mseep servers remove oldserver        # remove a server

# Toggle servers
mseep enable "github"                 # fuzzy match and enable
mseep disable "burp" --yes            # disable without prompt
mseep toggle kubernetes               # toggle state

# Import from existing clients
mseep import --dry-run                # preview imports
mseep import --client warp            # import from specific client
mseep import --enable                 # enable imported servers immediately

# Profiles
mseep profiles list
mseep profiles create security burp semgrep ghidra
mseep profiles save mysession         # save current enabled servers
mseep profiles apply security         # apply a profile

# Status and health
mseep status                          # show all clients and sync state
mseep status --client claude --json   # JSON output for scripting
mseep health                          # run health checks
mseep health --fix                    # auto-disable failing servers

# Apply to clients
mseep apply                           # apply to all detected clients
mseep apply --client cursor           # apply to specific client
mseep apply -y                        # skip confirmation

# iCloud sync (macOS)
mseep sync status                     # check sync status
mseep sync enable                     # enable iCloud sync
mseep sync disable                    # disable sync, keep local copy

# Delivery mode
mseep mode get                        # show current mode
mseep mode set wrapper                # use mseep as proxy
mseep mode set basic                  # write servers directly to clients

交付方式

基本（默认）

每个启用的服务器都会直接写入每个检测到的客户端的配置文件中。简单，运行时不依赖于mseep。

包装器

每个客户端都配置了一个 mseep proxy 进入。mseep在运行时复用所有已启用的服务器，实现热重新加载和统一的工具命名空间，而无需重新启动客户端。

Claude Code ──stdio──▶ mseep proxy ──stdio──▶ ghidra MCP
                                   ──stdio──▶ burp MCP
                                   ──http──▶  semgrep MCP

Cursor      ──stdio──▶ mseep proxy ──stdio──▶ (isolated processes)

规范配置

单一真相来源 ~/Library/Application Support/mseep/canonical.json （如果启用，则同步到iCloud）。

{
  "servers": [
    {
      "name": "burp",
      "command": "/path/to/java",
      "args": ["-jar", "mcp-proxy.jar"],
      "transport": "stdio",
      "enabled": true,
      "description": "Burp Suite MCP proxy for web security testing",
      "tags": ["security", "web"],
      "secrets": [
        {"name": "BURP_API_KEY", "description": "API key for Burp", "required": false}
      ]
    }
  ],
  "profiles": {
    "security": ["burp", "semgrep", "ghidra"],
    "automation": ["playwright", "browser"],
    "devops": ["kubernetes", "portainer"]
  },
  "settings": {
    "mode": "basic"
  }
}

Icloud同步

启用iCloud同步，使您的MCP服务器配置在所有Mac上保持同步：

mseep sync enable

这会将您的规范配置移动到iCloud Drive并创建一个符号链接：

• 配置位置: ~/Library/Mobile Documents/com~apple~CloudDocs/mseep/canonical.json
• 符号链接: ~/Library/Application Support/mseep/canonical.json

建筑

cmd/mseep/           CLI entry point (Cobra commands)
internal/
  adapters/          Client adapters (claude, cursor, vscode, warp, etc.)
  app/               Core business logic (Apply, Status, Health, Toggle)
  config/            Canonical config schema and persistence
  diff/              Unified diff generation
  fuzzy/             Fuzzy matching with scoring
  health/            Health check implementations
  marketplace/       Server discovery from external sources
  proxy/             MCP multiplexer for wrapper mode
  style/             Lipgloss terminal styling
  tui/               Bubble Tea TUI application
  jsonc/             JSON with comments parser (for VS Code/Cursor)

许可证

麻省理工学院