麦克佩奇工具包

Name: 麦克佩奇工具包
Author: rohitsoni007

作者：rohitsoni0075 星标更新：2025-11-20

项目介绍

<div align="center"> <h1>MCP Gearbox CLI</h1> <h3><em>更快地设置高质量的MCP服务器。</em></h3> <img src="./media/mcp-gearbox-cli.png" alt="MCP Gearbox Logo"/> </div> <p align="center"> <strong>一个命令行工具，用于快速下载、配置和部署模型上下文协议（MCP）服务器，适用于AI代理——支持跨平台使用，包括Windows、macOS和Linux。</strong> </p> <p align="center"> <a href="https://github.com/rohitsoni007/mcp-gearbox-cli/actions/workflows/release.yml"><img src="https://github.com/rohitsoni007/mcp-gearbox-cli/actions/workflows/release.yml/badge.svg" alt="发布"/></a> <a href="https://github.com/rohitsoni007/mcp-gearbox-cli/stargazers"><img src="https://img.shields.io/github/stars/rohitsoni007/mcp-gearbox-cli?style=social" alt="GitHub Stars"/></a> <a href="https://github.com/rohitsoni007/mcp-gearbox-cli/blob/main/LICENSE"><img src="https://img.shields.io/github/license/github/spec-kit" alt="许可证"/></a> <a href="https://github.com/rohitsoni007/mcp-gearbox-cli/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-blue" alt="文档"/></a> </p>

文档

详细使用说明，请访问我们的文档。

🤔 概述

MCP Gearbox 是一个强大的 Python 命令行开发工具包，提供了一种交互方式来发现、下载和配置来自官方生态系统的模型上下文协议（MCP）服务器。这个由AI驱动的工具会自动配置模型上下文协议服务器，适用于您首选的AI编码代理，并具有跨平台支持和智能配置管理。

⚡ 安装

使用 uv（推荐）

uv tool install mcp-gearbox --from git+https://github.com/rohitsoni007/mcp-gearbox-cli

升级 mcp-cli

uv tool install mcp-gearbox --force --from git+https://github.com/rohitsoni007/mcp-gearbox-cli

使用 uvx（一次性执行）

uvx --from git+https://github.com/rohitsoni007/mcp-gearbox-cli mcp-cli

使用 uv 和 pip

uv tool install mcp-gearbox

使用 npm

npm install -g mcp-gearbox

使用 pip

pip install mcp-gearbox

开发安装

git clone https://github.com/rohitsoni007/mcp-gearbox-cli
cd mcp-gearbox-cli
uv sync

🤖 支持的AI代理

代理	支持	备注
GitHub Copilot	✅
Continue	✅
Kiro	✅
Cursor	✅
Claude Code	✅
Gemini CLI	✅
Qoder	⚠️	Qoder 不支持项目级别的MCP配置
Copilot CLI	✅	Copilot CLI 不支持项目级别的MCP配置
LM Studio	✅	LM Studio 不需要项目级别的MCP配置
Google Antigravity	✅	Google Antigravity 不支持项目级别的MCP配置

🔧 MCP CLI 参考

mcp 命令支持以下选项：

命令

命令	描述
`init`	初始化MCP配置（支持项目特定和全局配置）
`list`	列出已配置的MCP服务器或所有可用服务器
`rm`	从配置中移除MCP服务器
`check`	检查哪些AI代理已安装在您的系统上

`mcp init` 参数及选项

参数/选项	类型	描述
`<目录>`	参数	要初始化MCP配置的目录（使用 `.` 表示当前目录，省略表示全局配置）
`--servers`, `-s`	选项	直接添加的MCP服务器名称。多次使用（-s git -s filesystem）或空格分隔（-s "git filesystem"） - 可选
`--agent`, `-a`	选项	要配置的AI代理：`copilot`, `copilot-cli`, `continue`, `kiro`, `cursor`, `claude`, `gemini`, `qoder`, 或 `lmstudio`
`--json`, `-j`	选项	输出JSON格式，无标题或UI
`--pretty`	选项	美化JSON输出（默认：false）

`mcp list` 参数及选项

参数/选项	类型	描述
`--agent`, `-a`	选项	要列出服务器的AI代理：`copilot`, `copilot-cli`, `continue`, `kiro`, `cursor`, `claude`, `gemini`, `qoder`, `lmstudio`, 或 `antigravity`
`--project`, `-p`	选项	项目路径（使用 '.' 表示当前目录，省略表示全局配置）
`--servers`, `-s`	选项	列出所有可用的MCP服务器，而不是已配置的服务器
`--json`, `-j`	选项	输出JSON格式，无标题或UI
`--pretty`	选项	当列出可用服务器时美化JSON输出（默认：false）

`mcp rm` 参数及选项

参数/选项	类型	描述
`<服务器>`	参数	要移除的MCP服务器名称（例如，'git', 'filesystem'） - 可选
`--all`, `-A`	选项	移除所有MCP服务器
`--agent`, `-a`	选项	要配置的AI代理：`copilot`, `copilot-cli`, `continue`, `kiro`, `cursor`, `claude`, `gemini`, `qoder`, `lmstudio`, 或 `antigravity`
`--project`, `-p`	选项	项目路径（使用 '.' 表示当前目录，省略表示全局配置）
`--force`, `-f`	选项	跳过确认提示
`--json`, `-j`	选项	输出JSON格式，无标题或UI
`--pretty`	选项	美化JSON输出（默认：false）

`mcp check` 参数及选项

参数/选项	类型	描述
`--agent`, `-a`	选项	要检查的具体代理：`copilot`, `copilot-cli`, `continue`, `kiro`, `cursor`, `claude`, `gemini`, `qoder`, `lmstudio`, 或 `antigravity`
`--json`, `-j`	选项	输出JSON格式，无标题或UI
`--pretty`	选项	美化JSON输出（默认：false）

🔧 使用示例

# 检查哪些AI代理已安装在您的系统上
mcp check

# 交互式选择模型上下文协议服务器（从可用的AI代理中选择）
# 全局配置MCP
mcp init

# 全局配置MCP以支持GitHub Copilot AI代理
mcp init -a copilot

# 全局配置MCP以支持Copilot CLI
mcp init -a copilot-cli

# 全局配置MCP以支持Continue AI
mcp init -a continue

# 全局配置MCP以支持Kiro AI代理
mcp init -a kiro

# 全局配置MCP以支持Cursor AI代理
mcp init -a cursor

# 全局配置MCP以支持Qoder AI代理
mcp init -a qoder

# 全局配置MCP以支持Claude Code
mcp init -a claude

# 全局配置MCP以支持Gemini CLI
mcp init -a gemini

# 全局配置MCP以支持LM Studio AI代理
mcp init -a lmstudio

# 全局配置MCP以支持Google Antigravity
mcp init -a antigravity

# 直接添加特定的MCP服务器，无需交互选择
# 方法1：用引号括起来的空格分隔
mcp init -a copilot --servers "git filesystem"

# 方法2：多个选项标志
mcp init -a copilot -s git -s filesystem

# 为Continue AI添加特定服务器并输出紧凑的JSON
mcp init -a continue --servers "git filesystem" --json

# 为Continue AI添加特定服务器并输出美化后的JSON
mcp init -a continue --servers "git filesystem" --json --pretty

# 将服务器添加到当前目录项目
mcp init . -a copilot --servers "git filesystem"

# 将服务器添加到新项目目录
mcp init my-project -a continue -s git -s filesystem

# 在当前目录初始化MCP
mcp init .

# 在新项目目录初始化MCP
mcp init my-project

# 在新项目目录初始化MCP以支持GitHub Copilot AI代理
mcp init my-project -a copilot

# 在新项目目录初始化MCP以支持Continue AI代理
mcp init my-project -a continue

# 在新项目目录初始化MCP以支持Kiro AI代理
mcp init my-project -a kiro

# 在新项目目录初始化MCP以支持Cursor AI代理
mcp init my-project -a cursor

# 在新项目目录初始化MCP以支持Claude Code
mcp init my-project -a claude

# 在新项目目录初始化MCP以支持Gemini CLI
mcp init my-project -a gemini

# 在新项目目录初始化MCP以支持Google Antigravity
mcp init my-project -a antigravity

`mcp list` 示例

# 交互式列出MCP服务器（从可用的AI代理中选择）
# 列出全局配置中的服务器
mcp list

# 列出特定代理的全局配置中的服务器
mcp list -a copilot
mcp list -a copilot-cli
mcp list -a continue
mcp list -a kiro
mcp list -a cursor
mcp list -a claude
mcp list -a gemini
mcp list -a qoder
mcp list -a lmstudio
mcp list -a antigravity

# 列出当前目录配置中的服务器
mcp list -p .

# 列出特定项目目录中的服务器
mcp list -p my-project

# 列出特定项目中的特定代理的服务器
mcp list -a copilot -p my-project

# 输出JSON格式（适用于脚本和自动化）
mcp list -a continue --json
mcp list -a continue -j

# 项目特定配置的JSON输出
mcp list -a continue -p my-project --json
mcp list -a continue -p my-project -j

# 列出所有可用的MCP服务器（交互显示）
mcp list --servers
mcp list -s

# 列出所有可用的MCP服务器并输出JSON格式（美化打印）
mcp list --servers --json

# 列出所有可用的MCP服务器并输出美化后的JSON
mcp list --servers --json --pretty
mcp list -s -j --pretty

`mcp rm` 示例

# 交互式移除MCP服务器（从已配置的服务器中选择）
# 从全局配置中移除服务器
mcp rm

# 特定代理的交互式移除
mcp rm -a copilot
mcp rm -a copilot-cli

# 从全局配置中移除特定的MCP服务器
mcp rm git filesystem

# 从GitHub Copilot AI代理中移除特定服务器
mcp rm git filesystem -a copilot

# 从Copilot CLI中移除特定服务器
mcp rm git filesystem -a copilot-cli

# 从Continue AI中移除特定服务器
mcp rm git filesystem -a continue

# 从Kiro AI代理中移除特定服务器
mcp rm git filesystem -a kiro

# 从Cursor AI代理中移除特定服务器
mcp rm git filesystem -a cursor

# 从Claude Code中移除特定服务器
mcp rm git filesystem -a claude

# 从Gemini CLI中移除特定服务器
mcp rm git filesystem -a gemini

# 从Google Antigravity中移除特定服务器
mcp rm git filesystem -a antigravity

# 从全局配置中移除所有MCP服务器
mcp rm --all

# 移除特定代理的所有服务器
mcp rm --all -a copilot
mcp rm --all -a copilot-cli

# 从当前目录配置中交互式移除
mcp rm -p .

# 从特定项目目录中交互式移除
mcp rm -p my-project

# 从当前目录配置中移除特定服务器
mcp rm git filesystem -p .

# 从特定项目目录中移除特定服务器
mcp rm git filesystem -p my-project

# 从项目目录中移除所有服务器
mcp rm --all -p my-project

# 强制移除服务器（跳过确认）
mcp rm git filesystem --force

# 强制移除所有服务器
mcp rm --all --force

# 输出JSON格式（适用于脚本和自动化）
mcp rm git filesystem -a continue --json
mcp rm git filesystem -a continue -j

# 输出美化后的JSON格式（人类可读）
mcp rm git filesystem -a continue --json --pretty

# 移除所有服务器并输出JSON
mcp rm --all -a continue --json
mcp rm --all -a continue -j

# 移除所有服务器并输出美化后的JSON
mcp rm --all -a continue --json --pretty

# 从项目中移除服务器并输出JSON
mcp rm git filesystem -p my-project -a continue --json
mcp rm git filesystem -p my-project -a continue -j

`mcp check` 示例

# 检查所有AI代理的安装状态
mcp check

# 检查特定代理的安装状态
mcp check -a copilot
mcp check -a copilot-cli
mcp check -a continue
mcp check -a kiro
mcp check -a cursor
mcp check -a claude
mcp check -a gemini
mcp check -a qoder
mcp check -a lmstudio
mcp check -a antigravity

# 输出JSON格式（适用于脚本和自动化）
mcp check --json
mcp check -j

# 输出美化后的JSON格式（人类可读）
mcp check --json --pretty
mcp check -j --pretty

# 检查特定代理并输出JSON
mcp check -a continue --json
mcp check -a continue -j

# 检查特定代理并输出美化后的JSON
mcp check -a continue --json --pretty

通用示例

# 显示版本
mcp --version
mcp -v

📚 功能

🎯 交互式AI代理选择和配置
📋 交互式MCP服务器选择，带有智能过滤
🔧 自动生成模型上下文协议配置文件
🌍 跨平台Python开发工具支持（Windows、Linux、macOS）
📁 自动检测AI代理配置路径
🔍 系统范围内的AI代理安装检测和状态检查
🔠 基于CLI的工作流程，实现无缝的开发者体验

🎯 实验性目标

所有AI代理的通用MCP服务器 - 不同AI平台之间的统一配置和管理
未来编辑功能 - 计划的功能，用于修改和更新现有的MCP配置

开发

项目结构

mcp-gearbox-cli/
├── src/mcp_cli/           # 主CLI包
│   ├── __init__.py        # 核心CLI功能
├── templates/             # 配置模板
└── scripts/               # 构建和部署脚本

🔧 要求

Linux/macOS/Windows
uv 用于包管理
Python 3.11+
Git

如果您