mcpup (Mohammedsamin)

mcpup

通过一个CLI跨13个AI客户端管理MCP服务器。

定义一次服务器。在您想要的地方启用它。保持非托管客户端条目的完整性。

______________________________________________________________________

为什么选择mcpup

MCP服务器很有用，但跨多个AI客户端管理它们是重复的，而且容易出错：

• 不同的配置位置
• 不同格式(JSON, JSONC, TOML)
• 重复的env/标头设置
• 易于覆盖手动客户端条目
• 很难回滚错误的配置写入

mcpup为您提供了一个规范配置 ~/.mcpup/config.json 并保持客户端特定文件的同步。

你得到了什么

• MCP服务器的一个真实来源
• 支持13个客户
• 97个内置服务器模板
• 本地 stdio 远程 HTTP/SSE 服务器定义
• 保留非托管项的所有权感知写入
• 备份、回滚、漂移检查，以及 doctor
• 交互式向导加上完整的CLI和JSON输出

快速入门

交互模式

跑 mcpup 没有争论：

mcpup

当前向导菜单：

? What would you like to do?
  → Quick setup (recommended)
    Add a server
    Remove a server
    Enable / Disable a server
    List servers
    Browse server registry
    Status overview
    Profiles
    Run doctor
    Rollback a client
    Exit

CLI模式

# Guided onboarding
mcpup setup

# Add a registry server
mcpup add github --env GITHUB_TOKEN=ghp_xxx

# Add a custom local server
mcpup add my-server --command npx --arg -y --arg my-mcp-package

# Add a remote HTTP/SSE server
mcpup add my-remote --url https://api.example.com/mcp --header "Authorization:Bearer sk-xxx"

# Enable it on clients
mcpup enable github --client cursor
mcpup enable github --client claude-code

# Preview changes before writing
mcpup enable github --client codex --dry-run

# Diagnose problems
mcpup doctor

# Roll back a client config
mcpup rollback --client cursor

安装

家酿

brew tap mohammedsamin/tap
brew install mcpup

走

go install github.com/mohammedsamin/mcpup/cmd/mcpup@latest

二进制发行版

下载自 发布.

内置注册表

mcpup船用 97个精心策划的MCP服务器模板 因此，您不必手动追逐包名或命令语法。

mcpup registry

示例：

mcpup add github --env GITHUB_TOKEN=ghp_xxx
mcpup add notion --env NOTION_TOKEN=ntn_xxx
mcpup add playwright
mcpup add memory

注册表包括以下类别：

• 开发者
• 搜索
• 生产力
• 效用
• 数据库
• 自动化
• 媒体
• 云
• 人工智能
• 沟通
• 金融
• 开发运维
• 安全
• 分析

支持的客户

mcpup目前管理这些客户端：

• 克劳德代码
• 光标
• 克劳德桌面版
• 法典
• 开源代码
• 帆板运动
• 泽德
• 继续
• VS Code
• 克莱恩
• Roo代码
• 亚马逊Q
• 双子座

有关确切的配置位置和每个客户端的行为，请参阅 docs/clients.md.

运作原理

~/.mcpup/config.json
        |
        +--> mcpup planner + reconciler
                |
                +--> native client config files

核心流程为：

1. 在规范配置中定义一次服务器
2. 为每个客户端启用或禁用它
3. mcpup计算所需的客户端状态
4. 它备份目标配置
5. 它编写本机客户端格式
6. 它验证结果并在失败时回滚

安全模型

• 保留非托管客户端条目
• 在每次写入之前创建备份
• 支持每个客户端的显式回滚
• 对破坏性的管理更改发出警告
• 通过以下方式验证配置形状、可执行文件、环境要求、漂移和所有权 doctor

常见工作流程

设置工作配置文件

mcpup add github --env GITHUB_TOKEN=ghp_xxx
mcpup add slack --env SLACK_BOT_TOKEN=xoxb-xxx
mcpup add notion --env NOTION_TOKEN=ntn_xxx
mcpup add sentry --env SENTRY_AUTH_TOKEN=sntrys_xxx

mcpup profile create work --servers github,slack,notion,sentry
mcpup profile apply work --yes

更新注册表支持的定义

mcpup update --yes

导出和导入服务器包

mcpup export --servers github,notion --output team-pack.json
mcpup import team-pack.json

带有JSON输出的脚本

mcpup list --json | jq '.data.servers[].name'
mcpup status --json | jq '.data.clients'

命令概述

有关完整的命令详细信息，请参阅 docs/commands.md.

文档

• 建筑
• 命令
• 客户
• 配置架构
• 例子
• 故障排除
• 安全模型
• 贡献

发展

go test ./...
go build ./cmd/mcpup
./mcpup

或者使用项目助手：

make build
make test
make fmt
make lint

许可证

麻省理工学院