Mcpgod

🚀 MCPGod 中文文檔

MCPGod 是一款強大的命令行工具，專為開發者高效管理 MCP 服務器而設計。它能讓您輕鬆完成添加、運行、列出服務器等操作，還能與服務器工具進行交互。而且，MCPGod 支持 Windows、macOS 或 Linux 系統，為不同系統的開發者提供了便利。

🚀 快速開始

MCPGod 是一款命令行工具，可幫助開發者高效管理 MCP 服務器。通過簡單的命令，就能實現服務器的添加、運行、列出等操作，還能與服務器工具進行交互，適用於多種操作系統。

✨ 主要特性

• 客戶端管理：可添加、移除和列出特定客戶端的 MCP 服務器。
• 工具發現：能查看任意 MCP 服務器上的所有可用工具。
• 工具調用：可直接從命令行運行任意 MCP 服務器上的工具。
• 權限控制：能設置或限制特定客戶端對某些工具的訪問權限。
• 日誌記錄：記錄每個客戶端每次運行服務器的日誌，包含時間戳和清晰的輸出，方便調試。

📦 安裝指南

使用 npm 全局安裝

使用以下命令全局安裝 MCPGod：

npm install -g mcpgod

安裝完成後，可通過以下命令驗證安裝是否成功：

god --version

通過 npx 直接運行

若不想全局安裝，也可直接通過 npx 運行：

npx -y mcpgod

💻 使用示例

基礎用法

通過命令 god（或 npx -y mcpgod）訪問 CLI。以下是一些常用示例：

• 將服務器添加到客戶端 將 MCP 服務器添加到特定客戶端（例如 Claude）：

god add @modelcontextprotocol/server-everything -c claude

• 為客戶端指定特定工具 添加服務器時僅配置部分工具：

god add @modelcontextprotocol/server-everything -c claude --tools=echo,add

• 列出客戶端的服務器 查看某個客戶端的所有已配置服務器：

god list -c claude

• 移除服務器 從客戶端配置中移除特定 MCP 服務器：

god remove @modelcontextprotocol/server-everything -c claude

• 運行服務器 啟動指定客戶端的 MCP 服務器：

god run -c claude

📚 詳細文檔

日誌記錄

所有日誌文件存儲在 ~/.config/mcpgod/logs 目錄下，按日期分類組織。

開發指南

MCPGod 使用 Oclif 框架開發。要開始本地開發，請執行以下步驟：

git clone https://github.com/your-repository.git
cd mcpgod
npm install

貢獻指南

歡迎參與項目！請按照以下步驟貢獻代碼：

1. 叉取倉庫

git clone https://github.com/your-repository.git
cd mcpgod

2. 創建新分支 為新功能或修復創建獨立的分支：

git checkout -b feature/your-feature-name

3. 提交更改 提交您的修改：

git add .
git commit -m "描述您所做的變更"
git push origin feature/your-feature-name

4. 創建 Pull Request 在 GitHub 上為您的分支提交 Pull Request，詳細說明變更內容。

📄 許可證

本項目採用 MIT License 許可證。

🔗 額外資源

• Oclif CLI 框架
• 模型上下文協議
• npm 包 mcpgod