MCP CLI Manager
- agent-framework
MCP CLI Manager - 一個用於管理多個服務器的命令行工具
About
What is MCP CLI Manager?
MCP CLI Manager is a command-line tool for managing Model Context Protocol (MCP) servers. It runs on Node.js and can be installed via npm or Homebrew, targeting developers who need to register, start, stop, and monitor MCP servers.
How to use MCP CLI Manager?
Install the tool using npm install -g mcp-cli-manager or via Homebrew. Then use commands such as mcp register <name>, mcp start <name>, mcp stop <name>, mcp status, mcp list, mcp search <query>, and mcp sync. Configuration files are stored at ~/.cursor/config/global.json and ~/.cursor/config/cursor.json.
Key features of MCP CLI Manager
- Register and manage multiple MCP servers.
- Support for npx and binary server types.
- Automatic logging and management.
- Server status monitoring.
- Global and local configuration management.
- Server search functionality.
Use cases of MCP CLI Manager
- Registering a new MCP server from the command line.
- Starting and stopping individual or all MCP servers.
- Checking the running status of registered servers.
- Searching for available MCP servers by query.
FAQ from MCP CLI Manager
What platforms does MCP CLI Manager support?
It requires Node.js 20.x and can be installed via npm (cross‑platform) or Homebrew (macOS/Linux).
What server types are supported?
It supports npx and binary server types, as well as Cursor, Claude, and custom servers.
Is the project currently stable?
No. The README states that version 1.0.8 has known issues – server startup fails and configuration management does not update properly. The author advises not to use the project and plans to fix it after April 13.
How do I install MCP CLI Manager?
Install via npm: npm install -g mcp-cli-manager or via Homebrew: brew tap crayon3shawn/homebrew-tap && brew install mcp-cli-manager.
What is the license?
MCP CLI Manager is licensed under the MIT License.
Details
- Author
- crayon3shawn
- GitHub stars
- 3
- Category
- agent-framework
- Repository
- crayon3shawn/mcp-cli-manager
目前的專案有問題，先不要使用
npm上面的版本目前是1.0.8
1.0.8 版本問題報告：
主要問題：
服務器啟動功能異常
嘗試啟動服務器時出現錯誤 Failed to start server: Process exited with code 128
可能與配置文件管理有關
配置文件管理問題
雖然可以列出已安裝的服務器
但配置文件 (~/.config/mcp-cli-manager/config.json) 沒有正確更新
導致服務器的配置信息無法正確保存
正常功能：
mcp search - 搜索功能正常
mcp list - 列表顯示功能正常
mcp status - 狀態查看功能正常
我可能要4/13之後才能回來修復，不好意思(或是大大要直接push也可以
---
MCP CLI Manager
A command-line tool for managing Model Context Protocol (MCP) servers, with support for various server types and connection methods.
Features
- Manage multiple MCP servers
- Support for different server types:
- Cursor
- Claude
- Custom servers
- Easy server installation and management
- Status monitoring and control
- TypeScript support with full type safety
Installation
Using Homebrew
brew tap crayon3shawn/homebrew-tap
brew install mcp-cli-manager
Using npm
npm install -g mcp-cli-manager
Usage
# List all installed servers
mcp-cli-manager list
Install a new server
mcp-cli-manager install <server-name>
Start a server
mcp-cli-manager run <server-name>
Stop a server
mcp-cli-manager stop <server-name>
Check server status
mcp-cli-manager status <server-name>
Development
This project uses pnpm as the package manager and is structured as a monorepo:
mcp-cli-manager/
├── packages/
│ ├── core/ # Core functionality
│ ├── cli/ # CLI tool
│ ├── server/ # Server-related code
│ ├── config/ # Configuration management
│ └── shared/ # Shared utilities and types
├── pnpm-workspace.yaml
└── package.json
Prerequisites
- Node.js 20.x
- pnpm 8.x
- Git
Setup
1. Clone the repository:
git clone https://github.com/crayon3shawn/mcp-cli-manager.git
cd mcp-cli-manager
2. Install dependencies:
pnpm install
3. Build the project:
pnpm build
Development Commands
# Run tests
pnpm test
Run tests with coverage
pnpm test:coverage
Lint code
pnpm lint
Format code
pnpm format
Contributing
1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Thanks to all contributors who have helped shape this project
- Special thanks to the MCP community for their feedback and suggestions
<a name="中文"></a>
MCP CLI Manager
一個用於管理 MCP Server 的命令行工具。
功能特點
- 註冊和管理 MCP Server
- 支持 npx 和 binary 類型的服務器
- 自動日誌記錄和管理
- 服務器狀態監控
- 全局和本地配置管理
- 服務器搜索功能
安裝
使用 npm
npm install -g mcp-cli-manager
使用 Homebrew
brew tap crayon3shawn/tap
brew install mcp-cli-manager
使用方法
註冊 MCP Server
mcp regist <name>
例如：
mcp register github
啟動 MCP Server
mcp start <name>
停止 MCP Server
mcp stop <name>
停止所有 MCP Server
mcp stop
查看 MCP Server 狀態
mcp status
列出所有 MCP Server
mcp list
搜索 MCP Server
mcp search <query>
同步 MCP Server 配置
mcp sync
配置
配置文件位於：
- 全局配置：~/.cursor/config/global.json
- Cursor 配置：~/.cursor/config/cursor.json
日誌
服務器日誌位於：~/.cursor/logs/<server-name>.log
開發
# 安裝依賴
npm install
構建
npm run build
運行測試
npm test
---
<a name="english"></a>
MCP CLI Manager
A command-line tool for managing MCP Servers.
Features
- Register and manage MCP Servers
- Support for npx and binary server types
- Automatic logging and management
- Server status monitoring
- Global and local configuration management
- Server search functionality
Installation
Using npm
npm install -g mcp-cli-manager
Using Homebrew
brew tap crayon3shawn/tap
brew install mcp-cli-manager
Usage
Register MCP Server
mcp register <name>
Example:
mcp register github
Start MCP Server
mcp start <name>
Stop MCP Server
mcp stop <name>
Stop All MCP Servers
mcp stop
Check MCP Server Status
mcp status
List All MCP Servers
mcp list
Search MCP Servers
mcp search <query>
Sync MCP Server Configuration
mcp sync
Configuration
Configuration files are located at:
- Global config: ~/.cursor/config/global.json
- Cursor config: ~/.cursor/config/cursor.json
Development
# Install dependencies
npm install
Build
npm run build
Run tests
npm test
