mseep
一个快速的CLI/TUI,用于从单个规范配置管理所有AI工具中的MCP(模型上下文协议)服务器。在一个地方切换服务器、切换配置文件、运行健康检查和浏览市场。
特性
- 统一配置 --管理MCP服务器一次,同步到所有客户端
- Icloud同步 --在所有Mac上同步您的配置
- 切换开关 --使用视觉反馈启用/禁用服务器
- 快速配置文件 --按1-9可立即切换服务器配置文件
- 导入现有 --从当前客户端配置中发现和导入服务器
- 安全合并 --从不接触不由mseep管理的服务器
支持的客户
| 客户端 | 配置路径 | 注释 |
|---|---|---|
| 克劳德桌面 | ~/Library/Application Support/Claude/claude_desktop_config.json | |
| 克劳德代码 | ~/.claude.json | |
| 光标 | ~/Library/Application Support/Cursor/User/settings.json | JSONC支持 |
| VS代码 | ~/Library/Application Support/Code/User/settings.json | JSONC支持 |
| Cline | VSCode扩展全局存储 | |
| Warp | SQLite数据库+ ~/.warp/mcp_config.json | 从Warp的内部数据库读取 |
| 粉碎 | ~/.local/share/crush/crush.json | |
| OpenCode | ~/.config/opencode/opencode.json | |
| LM工作室 | ~/.cache/lm-studio/mcp-config.json | |
| 鹅 | ~/.config/goose/mcp-config.json |
所有路径都是平台感知的(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 ... │
└─────────────────────────────────────────────────────────────────┘按键绑定
| 关键 | 行动 |
|---|---|
Space / Enter / t | 切换所选服务器 |
1-9 | 快速应用配置文件(显示在状态栏中) |
a | 将更改应用于所有客户端 |
m | 切换交付模式(基本/包装) |
r | 刷新 |
← / → / Tab | 切换选项卡 |
? | 帮助 |
q | 退出 |
标签页
| 选项卡 | 说明 |
|---|---|
| 服务器 | 打开/关闭服务器,请参阅说明和标签 |
| 档案 | 应用已保存的服务器配置文件 |
| 状态 | 客户端同步状态(哪些服务器与哪些客户端同步) |
| 健康 | 对已启用的服务器运行健康检查 |
| 应用 | 将规范配置应用于所有检测到的客户端 |
| 市场 | 从mcpservers.org浏览和安装服务器 |
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)许可证
麻省理工学院
