MCP服务器包管理器

stewrd是一个用于管理多平台MCP服务器的工具,提供发现、安装和同步功能,适用于Claude Code、Claude Desktop、Cursor、Windsurf和VS Code等客户端。

  • by dodenbach
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dodenbach/stewrd-cli

使用说明

炖肉

MCP服务器的包管理器。

从一个CLI跨Claude Code、Claude Desktop、Cursor、Windsurf和VS Code发现、安装和同步MCP服务器。

为什么?

MCP服务器分散在多个AI客户端上。不同的JSON文件,不同的格式,无法查看配置在哪里。在Claude Code中添加服务器,手动将配置复制到Cursor,然后是Windsurf,然后是Claude Desktop。忘了一个?它默默地不起作用。

斯特沃德解决了这个问题。 一个命令,看到一切。一个命令可以在任何地方同步。

安装

npm install -g stewrd

命令

stewrd scan

查看您计算机上所有客户端上的每个MCP服务器。

$ stewrd scan

  stewrd scan — MCP servers on this machine

  ● Claude Code (3 servers)
  ├─ pencil                   stdio      /Applications/Pencil.app/...
  ├─ supabase                 http       https://mcp.supabase.com/mcp
  └─ github                   http       https://api.githubcopilot.com/mcp/

  ● Cursor (1 server)
  └─ supabase                 http       https://mcp.supabase.com/mcp

  ○ Claude Desktop (none)

  ─────────────────────────────────────────────────
  4 servers across 3 clients
  3 unique, 1 shared across clients

stewrd sync

跨所有客户端同步服务器。在一个客户端中配置的服务器将添加到所有其他客户端中。

# Preview what would be synced
stewrd sync --dry-run

# Sync everything
stewrd sync

stewrd add <server>

将服务器添加到特定客户端。

# Add an npx-based server to Claude Code
stewrd add @modelcontextprotocol/server-filesystem

# Add to a specific client
stewrd add my-server --client cursor --command npx --args "-y @my/mcp-server"

# Add an HTTP server
stewrd add my-api --url https://mcp.example.com/mcp --client claude-desktop

stewrd remove <server>

从客户端删除服务器。

stewrd remove my-server --client claude-code

stewrd doctor

检查您的MCP配置是否存在安全问题和配置错误。

$ stewrd doctor

  stewrd doctor — MCP health check

  ⚠ WARNINGS (2)
    ⚠ my-server (Claude Code)
      Unpinned npm package version
      Fix: stewrd add my-server --command npx --args "-y @my/server@1.2.0"
    ⚠ custom-tool (Cursor)
      Plaintext secret in env: API_TOKEN
      Fix: Use environment variable reference: ${API_TOKEN}

  ℹ INFO (1)
    ℹ supabase (Claude Code)
      Only configured in Claude Code — missing from 2 other clients
      Fix: stewrd sync

支持的客户

客户端 配置位置 状态
克劳德代码 ~/.claude/.mcp.json ✅
克劳德桌面 ~/Library/Application Support/Claude/claude_desktop_config.json ✅
光标 ~/.cursor/mcp.json ✅
风帆冲浪 ~/.codeium/windsurf/mcp_config.json ✅
VS代码 VS代码 settings.json ✅

运作原理

steward从每个受支持的客户端读取MCP配置文件,规范服务器定义,并可以为每个客户端以正确的格式将其写回。当你 sync,它将所有客户端上的所有服务器合并,并将缺失的服务器添加到它们所属的位置。

所有写入创建 .bak 在修改原始配置文件之前对其进行备份。

许可证

麻省理工学院