Mcpbar

🚀 MCP 巴 CLI 管理器

MCP 巴 CLI 管理器是一款用於管理 MCP 服務器的命令行界面工具，能幫助用戶簡單高效地完成服務器的安裝與管理，且支持跨平臺使用。

🚀 快速開始

MCP 巴 CLI 管理器可讓你輕鬆管理 MCP 服務器。以下是基本的使用步驟：

1. 安裝該工具。
2. 安裝、卸載或列出 MCP 服務器。

✨ 主要特性

• 🔄 簡單安裝和管理 MCP 服務器，讓服務器管理工作變得輕鬆。
• 📱 跨平臺支持，無論你使用何種操作系統，都能正常使用。

📦 安裝指南

使用以下命令全局安裝 MCP 巴 CLI 管理器：

npm install -g mcpbar

💻 使用示例

基礎用法

# 🔍 安裝一個服務器
mcpbar install playwright # 安裝 Playwright 服務器

# 🗑️ 卸載一個服務器
mcpbar remove playwright # 卸載 Playwright 服務器

# 📋 列出已安裝的服務器
mcpbar list # 顯示設備上已安裝的 MCP 服務器

📚 詳細文檔

運行命令

• 在開發模式下，使用 pnpm start [command name] 來運行任何命令。此方法利用了 ts-node，提供無縫的開發體驗。
• 在生產環境中，直接從構建後的項目執行 CLI 應用程序，格式為 mcpbar [command name]。

所有命令均位於 src/commands/ 文件夾中。這種組織方式便於查找和修改現有命令，或添加新的命令。

代碼規範與工具

• 代碼風格：使用 Prettier 進行代碼格式化，確保代碼風格統一。
• 代碼檢查：使用 ESLint 進行代碼質量檢測，及時發現並解決潛在問題。
• 類型定義：使用 TypeScript 提供類型安全，增強代碼的可靠性。

提交規範

項目採用 conventional commit 規範進行版本控制。提交信息需遵循以下格式：

type(scope): short message
long message...

其中：

• type 可以為 feat（新功能）、fix（修復問題）或 chore（其他變動）。
• scope 描述修改的範圍，如 cli, config, 或 deps。

測試

項目使用 Jest 進行單元測試和集成測試。請在修改代碼後運行：

npm test

貢獻指南

歡迎貢獻！如果你想改進此 CLI 工具，請按照標準的叉倉庫和拉取請求流程進行操作。以下是一些注意事項：

• 確保你的代碼符合項目的編碼規範，包括使用 Prettier 進行格式化以及 ESLint 進行代碼檢查。
• 遵循 conventional commit 格式編寫提交信息。項目採用 commitizen 和 commitlint 結合 @commitlint/config-conventional 配置，並通過 Husky 設置預提交鉤子進行驗證。
• 為新功能或修復問題添加相應的測試用例。

CI/CD 自動化

測試

項目使用 Jest 進行單元測試和集成測試。請在修改代碼後運行：

npm test

構建

項目採用 Webpack 進行構建，生成 umd、esm 和 cjs 格式的文件。

發佈

要發佈新版本，請按照以下步驟操作：

1. 更新 CHANGELOG.md 文件。
2. 提交修改並推送到遠程倉庫。
3. 使用 npm 腳本進行構建和發佈：

npm run build
npm publish

📄 許可證

本項目使用 MIT 許可證，詳細內容請查看 LICENSE 文件。