madari (Ankitvg)

主席 （MUH-DAA-REE）

Madari是一个CLI，用于将MCP服务器部署到您的AI客户端设置中，具有可靠的安装、注册和同步功能。

安装

自制（推荐）：

brew tap ankitvg/tap
brew install madari

去：

go install github.com/ankitvg/madari/cmd/madari@latest

命令

• `madari install

[options]`

• madari add --command --client
• madari list
• madari remove
• madari enable
• madari disable
• `madari sync [--dry-run] [--config-path

]`

• madari clients
• madari doctor [--client-config target=path ...]
• madari status [--client-config target=path ...]
• `madari export [--file

]`

• `madari import --file

[--apply]`

• madari help [command]
• madari version

笔记：

• install 运行包管理器安装(uv 默认情况下，或 npm 通过 --manager npm)，自动注册服务器，并在一个命令中同步到配置的客户端。
• install 除非您使用 --skip-install 并通过 --command.
• install --manager npm 需要 --command 因为npm包名可能与可执行文件名不同。
• add 解决 --command 并将该路径存储在清单中。
• sync 跳过缺少/不可执行命令路径的服务器，并继续同步其他服务器。
• 支持的同步客户端： claude-desktop 和 claude-code.
• 默认同步配置路径：

- claude-desktop：平台特定的Claude Desktop配置路径。 - claude-code: /.mcp.json.

• install --config-path 仅当选择了一个同步目标时才能使用。
• export 编写一个版本化的JSON快照用于备份/共享（默认情况下为stdout）。
• import 默认情况下为模拟运行，仅添加/更新列出的服务器(--apply 坚持）。

Claude Code项目配置形状(.mcp.json):

{
  "mcpServers": {
    "stewreads": {
      "command": "/Users/me/.local/bin/stewreads-mcp",
      "args": ["--stdio"],
      "env": {
        "STEWREADS_CONFIG_PATH": "~/.config/stewreads/config.toml"
      }
    }
  }
}

例子：

madari install stewreads-mcp
madari install @modelcontextprotocol/server-sequential-thinking --manager npm --command mcp-server-sequential-thinking
madari add stewreads --command /Users/me/.local/bin/stewreads-mcp --client claude-desktop
madari add stewreads --command /Users/me/.local/bin/stewreads-mcp --client claude-code
madari list
madari status
madari sync claude-desktop --dry-run
madari sync claude-code --dry-run
madari export --file madari-snapshot.json
madari import --file madari-snapshot.json
madari import --file madari-snapshot.json --apply
madari doctor
madari help install
madari version

发展

构建：

make build

测试：

go test ./...

建筑

• 读取注册表状态，写入客户端配置；没有守护进程或代理
• 仅涉及Madari注册的条目；让其他一切顺其自然
• 每次同步时进行备份+原子写入；跳过无效条目而不是中止
• doctor 和 status 用于诊断
• 支持 uv 和 npm 包管理器安装，外加手动 add 适用于任何运行时/框架
• macOS、Linux和Windows；支持克劳德桌面和克劳德代码同步目标

原则

• 地方优先，透明
• 人类可读配置
• 安全写入（备份+原子替换）
• 明确管理条目的所有权

文档

• docs/architecture.md
• docs/manifest-spec.md
• docs/cli-reference.md
• docs/troubleshooting.md

许可证

Apache许可证2.0。看 LICENSE 和 NOTICE.