mcpset
用于保持MCP客户端配置同步的统一CLI。
一次管理MCP客户端设置的集成CLI。
______________________________________________________________________
英语
概述
mcpset 从Cursor、Claude、Codex CLI和其他客户端收集MCP服务器定义，并将其存储在单个 ~/.mcp/config.json，并在需要每个客户时同步应用它们。工作流程始终是 init → sync → 剪贴板.
特性
- 一个CLI流程包括收集、应用和共享。
- 仅追加合并可以保持本地调整不变。
- 适用于JSON（Cursor，Claude）和TOML（Codex CLI）目标。
- 模板驱动
mcpset add用于可重复的服务器定义。 - 合并帮助程序和CLI流的Pytest覆盖率。
安装
git clone https://github.com/Devdha/mcpset.git
cd mcpset
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
mcpset --help配置目标
目标居住 ~/.mcp/mcpset.targets.json。复制示例文件以开始：
mkdir -p ~/.mcp
cp examples/mcpset.targets.example.json ~/.mcp/mcpset.targets.json
cp examples/config.json.example ~/.mcp/config.json
cp examples/mcpset.templates.example.json ~/.mcp/mcpset.templates.json示例片段：
{
"targets": [
{"name": "root", "path": "~/.mcp/config.json", "type": "json", "root": "mcpServers"},
{"name": "cursor", "path": "~/.cursor/mcp.json", "type": "json", "root": "mcpServers"},
{"name": "claude", "path": "~/Library/Application Support/Claude/claude_desktop_config.json", "type": "json", "root": "mcpServers"},
{"name": "codex", "path": "~/.codex/config.toml", "type": "toml", "root": "mcp_servers"}
]
}核心命令
# Collect existing client configs into ~/.mcp/config.json
mcpset init --apply
mcpset init -f cursor claude # limit sources
# Push the central config back down to targets
mcpset sync --dry-run
mcpset sync
# Share safely
mcpset clipboard
mcpset clipboard -f cursor --stdout
mcpset clipboard --path ~/custom.json
# Utilities
mcpset files --verbose
mcpset list --view-mcp
mcpset add KEY -j '{"command":"python3"}' -f cursor root
mcpset remove KEY -f cursor
mcpset templates --show NAME工作流示例
mcpset init --apply # refresh central config on your main machine
mcpset sync --dry-run # verify what will change on a new machine
mcpset sync # apply for real
mcpset clipboard --stdout > shared-mcp.txt开发与测试
ruff check .
pytest打开PR时，一起更新README/example.tests，并在提交时保留真实的服务器端点或令牌。看 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md 了解详情。
项目状态
- \[x\] init/sync/剪贴板工作流测试
- \[x\] PyPI元数据+MIT许可证
- \[x\] GitHub操作CI（lint+pytest）
许可证
根据MIT许可证发布（见 LICENSE).
______________________________________________________________________
韩语
概述
mcpset是Cursor、Claude、Codex CLI等多个MCP客户端的 mcpServers 收集设置 ~/.mcp/config.json集成到，并在需要时重新部署到客户机，使您可以轻松地调整设备之间/团队之间的设置。总是 init → sync → 剪贴板 作为流进行操作。
特点
- 通过一个CLI流处理收集、分发和共享
- 不覆盖现有值的append-only合并
- 同时支持JSON/TOML目标
- 基于模板
mcpset add通过减少重复任务 - 使用pytest验证剩余逻辑和CLI方案
安装
git clone https://github.com/Devdha/mcpset.git
cd mcpset
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
mcpset --help目标配置
受管理的文件列表包括： ~/.mcp/mcpset.targets.json在中定义，复制示例文件后只需修改路径即可。
mkdir -p ~/.mcp
cp examples/mcpset.targets.example.json ~/.mcp/mcpset.targets.json
cp examples/config.json.example ~/.mcp/config.json
cp examples/mcpset.templates.example.json ~/.mcp/mcpset.templates.json主要命令
# 여러 클라이언트 설정을 읽어 중앙 config.json 갱신
mcpset init --apply
mcpset init -f cursor claude
# 중앙 config 내용을 각 타겟에 append-only 적용
mcpset sync --dry-run
mcpset sync
# 공유/백업용 출력
mcpset clipboard
mcpset clipboard -f cursor --stdout
mcpset clipboard --path ~/custom.json
# 유틸리티
mcpset files --verbose
mcpset list --view-mcp
mcpset add KEY -j '{"command":"python3"}' -f cursor root
mcpset remove KEY -f cursor
mcpset templates --show NAME工作流示例
mcpset init --apply
mcpset sync --dry-run
mcpset sync
mcpset clipboard --stdout > shared-mcp.txt开发&测试
ruff check .
pytest创建PR时，请同时更新README、示例和测试，并注意提交中不包括实际服务器地址或令牌。详细的贡献说明 CONTRIBUTING.md，行动纲领 CODE_OF_CONDUCT.md在。
当前状态
- \[x\]测试init/sync/clipboard流
- \[x\]维护PyPI元数据和MIT许可证
- \[x\]GitHub Actions等CI配置（lint+pytest）
许可证
MIT License（详细信息 LICENSE 请参阅）。