MCP CLI Manager logo

MCP CLI Manager

by crayon3shawn

A command-line tool for managing Model Context Protocol (MCP) servers. It supports various server types and connection methods, simplifying server management tasks.

View on GitHub

Last updated: N/A

搶修中 只專案先不要用

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

English | 中文

<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