AI导哈

MCP服务器包管理器

mcpiper是一个类似npm的MCP服务器包管理器，用于发现、安装和管理不同客户端（如Claude Code、Claude Desktop、Cursor等）上的MCP服务器。

  • by acarr
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 acarr/mcpiper

使用说明

麦派珀

用于MCP（模型上下文协议）服务器的类npm包管理器

mcpiper使跨不同客户端（如Claude Code、Claude Desktop、Cursor等）发现、安装和管理MCP服务器变得容易。

特征

  • 🔍 搜索 -在官方注册表中查找MCP服务器
  • 📦 安装 -使用简单命令添加服务器（支持npm包和远程服务器）
  • 🌐 远程服务器 -自动安装可流式传输的HTTP服务器（如Figma MCP）
  • 🗑️ 卸载 -轻松删除服务器
  • 📋 列表 -查看所有已安装的服务器
  • ℹ️ 信息 -获取详细的服务器信息
  • 🎯 多客户端 -支持克劳德代码、克劳德桌面、光标、VS代码等
  • ⚡ 快 -内置缓存，快速响应
  • 🔧 可配置的 -自定义默认客户端、缓存设置等

安装

npm install -g mcpiper

快速开始

搜索MCP服务器

mcpiper search chrome

安装MCP服务器

# Install using default client
mcpiper add chrome-devtools

# Install for specific client
mcpiper add chrome-devtools --claude-code
mcpiper add filesystem --claude-desktop

列出已安装的服务器

mcpiper list

# Filter by client
mcpiper list --client claude-code

获取服务器信息

mcpiper info chrome-devtools

删除服务器

mcpiper remove chrome-devtools

# Skip confirmation
mcpiper remove chrome-devtools --yes

配置

设置默认客户端

mcpiper config set default-client claude-code

查看所有配置

mcpiper config list

可用配置选项

  • defaultClient -要使用的默认MCP客户端
  • registryUrl -MCP注册表API URL（默认值：https://registry.modelcontextprotocol.io)
  • cacheEnabled -启用/禁用缓存（默认值：true）
  • cacheTTL -缓存生存时间（秒）（默认值：3600）

缓存管理

清除缓存

mcpiper cache clear

查看缓存统计信息

mcpiper cache info

支持的客户端

mcpiper会自动检测已安装的MCP客户端：

  • 克劳德代码 -Anthropic的CLI工具
  • 克劳德桌面版 -Claude桌面应用程序
  • 光标 -AI驱动的代码编辑器
  • VS Code -Visual Studio代码（通过扩展）

想添加对其他工具的支持吗？

mcpiper是可扩展的！ 通过创建新的适配器类，您可以轻松地为任何MCP客户端添加适配器。适配器系统旨在使添加对新工具的支持变得简单。

要添加对新客户端的支持，请执行以下操作：

  1. 创建一个扩展的新适配器类 BaseAdapter
  2. 实施所需的方法(detect, install, uninstall, list, getConfigPath)
  3. 在中注册您的适配器 AdapterRegistry

请参阅 贡献指南 有关添加新客户端适配器的详细说明。

运作原理

麦派珀使用官方 MCP注册表 根据您的客户端发现服务器并安装它们：

  • 克劳德代码：执行 claude mcp add 命令
  • 克劳德桌面版：修改 claude_desktop_config.json
  • 光标：更新光标设置
  • VS Code：修改VS代码设置

服务器类型

mcpiper支持两种类型的MCP服务器：

  1. npm包服务器：通过npx安装的传统本地MCP服务器
  2. 远程服务器：通过互联网连接的流式HTTP服务器（如Figma MCP）
    • 使用自动配置 mcp-remote 兼容性代理
    • 无需本地安装-直接连接到远程端点

所有安装都会被跟踪 ~/.mcpiper/config.json 便于管理。

命令

mcpiper add <server> [options]

安装MCP服务器。

选项：

  • --claude-code -安装Claude代码
  • --claude-desktop -为Claude Desktop安装
  • --cursor -为Cursor安装
  • --vscode -安装VS代码

mcpiper search <query> [options]

在注册表中搜索MCP服务器。

选项：

  • -l, --limit <number> -限制结果数量（默认值：10）
  • --no-cache -绕过缓存并获取新数据

mcpiper list [options]

列出已安装的MCP服务器。

选项：

  • -c, --client <name> -按客户筛选

mcpiper remove <server> [options]

卸载MCP服务器。

选项：

  • -y, --yes -跳过确认提示
  • --claude-code -从克劳德代码中删除
  • --claude-desktop -从克劳德桌面删除
  • --cursor -从光标中删除

mcpiper info <server>

显示有关MCP服务器的详细信息。

mcpiper config <command>

管理配置。

命令：

  • get <key> -获取配置值
  • set <key> <value> -设置配置值
  • list -列出所有配置值
  • unset <key> -取消设置配置值

mcpiper cache <command>

管理缓存。

命令：

  • clear -清除缓存
  • info -显示缓存统计信息

例子

# Search for filesystem-related servers
mcpiper search filesystem

# Install the Chrome DevTools server for Claude Code
mcpiper add chrome-devtools --claude-code

# Install a remote server (Figma MCP)
mcpiper add figma --claude-desktop

# Set Claude Code as your default client
mcpiper config set default-client claude-code

# Install a server (will use default client)
mcpiper add sqlite

# List all installed servers
mcpiper list

# Get information about a server
mcpiper info sqlite

# Remove a server
mcpiper remove sqlite --yes

# Clear the cache
mcpiper cache clear

配置文件

mcpiper将其配置和缓存存储在 ~/.mcpiper/:

~/.mcpiper/
├── config.json       # Main configuration
├── cache/            # Cached registry responses
└── backups/          # Config backups

需求

  • Node.js 18或更高版本
  • 至少安装了一个MCP客户端（Claude Code、Claude Desktop、Cursor等）

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

有关以下内容的详细信息：

  • 设置您的开发环境
  • 代码风格和测试要求
  • 添加新的客户端适配器
  • 拉取请求流程

查看我们的 贡献指南.

链接

相关 MCP