适用于Amazon Q CLI的MCP简易安装程序
针对Amazon Q CLI集成进行了优化的最终MCP服务器管理工具。
通过无缝的Amazon Q CLI集成自动安装、管理和配置MCP服务器。此工具通过自动执行来消除手动配置步骤 q mcp add/remove 命令。
______________________________________________________________________
🚀 主要特点
✨ Amazon Q CLI集成
- 自动安装：安装MCP服务器并自动将其添加到Amazon Q CLI
- 无缝管理：自动执行
q mcp add/remove命令 - 范围支持：管理全局和工作区MCP配置
- 错误恢复：如果自动执行失败，则提供手动命令
🔧 完整的MCP生命周期管理
- 安装：从GitHub/npm下载、构建和配置MCP服务器
- 搜索：使用关键字搜索在GitHub上查找MCP服务器
- 列表：显示已安装的服务器（全局/工作区/两个作用域）
- 卸载：删除服务器并清理配置
- 修理：使用卸载/重新安装工作流修复损坏的安装
______________________________________________________________________
📦 安装
先决条件
- 亚马逊Q CLI 已安装并配置
- Node.js（v16+）
- Git
快速设置
# Clone the repository
git clone https://github.com/bonjourzzz/mcp-easy-installer-clean.git
cd mcp-easy-installer-clean
# Install dependencies and build
npm install
npm run build
# Add to Amazon Q CLI (global scope)
q mcp add --name mcp-easy-installer --command node --args "$(pwd)/build/index.js" --scope global --force______________________________________________________________________
🎯 用法
安装后，在Amazon Q Chat中使用自然语言命令：
安装MCP服务器
"Install this MCP server: https://github.com/modelcontextprotocol/servers/tree/main/src/memory"
"Install the brave search MCP server"管理现有服务器
"List all my MCP servers"
"Show global MCP servers only"
"Uninstall the memory server"
"Repair the broken fetch server"搜索新服务器
"Search for Wikipedia MCP servers"
"Find MCP servers for file operations"______________________________________________________________________
🔧 配置
基本配置
该工具可与Amazon Q CLI一起开箱即用。对于GitHub搜索功能，可以选择添加GitHub令牌：
{
"mcpServers": {
"mcp-easy-installer": {
"command": "node",
"args": ["/path/to/build/index.js"],
"env": {
"GITHUB_TOKEN": "your_github_token_here"
}
}
}
}支持的语言
默认情况下，搜索TypeScript、JavaScript和HTML存储库。自定义 --langcode:
"args": [
"/path/to/build/index.js",
"--langcode=ts,js,html,py,sh"
]______________________________________________________________________
🏗️ 建筑
Amazon Q CLI集成
- 自动执行：用途
spawn-rx可靠地执行Q CLI命令 - 范围管理：支持全球(
~/.aws/amazonq/mcp.json)和工作空间(.amazonq/mcp.json)配置 - 错误处理：手动命令建议的优雅回退
安装目录
MCP服务器安装到：
- 视窗:
C:\Users\USERNAME\Documents\Flowvibe\MCP\ - Linux/Mac:
/home/USERNAME/Documents/Flowvibe/MCP/
支持的项目类型
- Node.js：自动
npm install，TypeScript编译，入口点检测 - python:
uv依赖关系管理、虚拟环境处理
______________________________________________________________________
🛠️ 可用工具
| 工具 | 描述 | Amazon Q CLI集成 |
|---|---|---|
install_mcp_server | 从GitHub/npm URL安装 | ✅ 自动 q mcp add |
search_mcp_server | 搜索GitHub存储库 | - |
list_mcp_servers | 列出已安装的服务器 | ✅ 用途 q mcp list |
uninstall_mcp_server | 删除服务器 | ✅ 自动 q mcp remove |
repair_mcp_server | 修复损坏的安装 | ✅ 完整的重新安装周期 |
______________________________________________________________________
🔍 故障排除
常见问题
Q CLI命令失败
- 确保Amazon Q CLI已安装并位于PATH中
- 检查全局/工作区范围的权限
- 提供手动命令作为后备
安装失败
- 验证Node.js/Python依赖关系
- 检查GitHub/npm的网络连接
- 查看错误日志以了解具体问题
搜索不起作用
- 将GitHub令牌添加到环境变量中
- 检查速率限制（60个请求/小时，无令牌）
______________________________________________________________________
🤝 贡献
这是MCP Easy Installer的Amazon Q CLI优化版本。欢迎捐款：
- 分叉存储库
- 创建特征分支
- 提交拉取请求
- 专注于亚马逊Q CLI集成改进
______________________________________________________________________
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件
______________________________________________________________________
🔗 链接
______________________________________________________________________
专为Amazon Q CLI用户打造 🚀