MCP CLI Ent

MCP CLI Ent

"Do not be hasty."

使用MCP服务器，而无需将其加载到代理的上下文窗口中。

CLI Ent =CLI工具+上下文守护器。不要将MCP工具定义加载到代理的上下文中，而是使用 mcp-cli-ent 按需调用工具。

主要特点

• 交叉平台的：适用于Linux、macOS、Windows
• 零依赖：单个二进制文件，无运行时要求
• 通用配置：与现有MCP配置兼容
• 双重运输：基于HTTP和stdio的服务器
• 多服务器：轻松管理多个MCP服务器
• 安全：凭据的环境变量替换
• 智能输出：智能处理二进制数据和图像
• 自动启动守护程序：自动创建浏览器会话

快速安装

Homebrew（Linux、WSL和macOS）：

brew install EstebanForge/tap/mcp-cli-ent

直接二进制安装（Linux、WSL和macOS）：

curl -fsSL https://raw.githubusercontent.com/EstebanForge/mcp-cli-ent/main/scripts/install.sh | bash

Windows（PowerShell）：

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/EstebanForge/mcp-cli-ent/main/scripts/install.ps1" -OutFile "install.ps1"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
.\install.ps1

注意：Windows支持是实验性的。欢迎投稿和测试。如果遇到问题，请使用Windows WSL（Linux）而不是Windows可执行文件。

快速开始

# Create configuration
mcp-cli-ent create-config

# List available servers
mcp-cli-ent

# List tools from a server
mcp-cli-ent list-tools context7

# Call a tool (get library docs via context7)
mcp-cli-ent call-tool context7 get-library-docs '{
  "context7CompatibleLibraryID": "/EstebanForge/hyperpress",
  "query": "how to create a custom block"
}'

截图

工具执行-通过Context7获取文档MCP CLI-ENT Server List

MCP CLI-ENT Tool Call

MCP CLI-ENT No Arguments

对于AI代理

添加到您的 AGENTS.md （或 CLAUDE.md，感谢您不遵守标准）：

Use MCP servers with CLI tool: `mcp-cli-ent`

或者：

MCP (Model Context Protocol) connects external tools. Use servers to fetch live docs, run complex reasoning, or automate browsers. Use them with CLI tool: `mcp-cli-ent`

配置

配置文件位置

# Create config in standard location (~/.config/mcp-cli-ent/mcp_servers.json)
mcp-cli-ent create-config

发现优先级：

1. `--config

` 旗帜

1. ~/.config/mcp-cli-ent/mcp_servers.json （Linux/macOS）
2. %APPDATA%\mcp-cli-ent\mcp_servers.json （Windows）
3. ./mcp_servers.json （当前目录）

JSON配置参考

{
  "mcpServers": {
    "server-name": {
      "enabled": true,
      "description": "Human-readable description",
      "type": "http",
      "url": "https://example.com/mcp",
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": {
        "API_KEY": "${ENV_VAR_NAME}"
      },
      "headers": {
        "Authorization": "Bearer ${TOKEN}"
      },
      "timeout": 30,
      "persistent": false,
      "session": {
        "type": "persistent",
        "autoStart": true,
        "timeout": 300,
        "maxIdle": 600,
        "healthCheck": true
      }
    }
  }
}

服务器配置密钥

会话配置（可选）

环境变量替换

使用 ${VAR_NAME} 或 $VAR_NAME 价值观：

{
  "args": ["--api-key", "${CONTEXT7_API_KEY}"],
  "env": { "API_KEY": "$MY_API_KEY" },
  "headers": { "Authorization": "Bearer ${TOKEN}" }
}

回退行为：对于每个变量，CLI首先检查未加前缀的名称（例如。， CONTEXT7_API_KEY)，然后回落到 ENT_ 前缀版本（例如。， ENT_CONTEXT7_API_KEY)如果第一个是空的。这可以防止与现有环境变量发生冲突。

# Linux/macOS - either format works
export CONTEXT7_API_KEY="your_key"
# or
export ENT_CONTEXT7_API_KEY="your_key"

# Windows PowerShell
$env:CONTEXT7_API_KEY = "your_key"
# or
$env:ENT_CONTEXT7_API_KEY = "your_key"

预配置服务器

示例配置包括：

CLI参考

全球旗帜

命令

# Server management
mcp-cli-ent                           # Show all tools from all servers
mcp-cli-ent list-servers              # List enabled servers
mcp-cli-ent list-servers --all        # Include disabled servers
mcp-cli-ent list-tools [server]       # List tools (all or specific server)

# Tool execution
mcp-cli-ent call-tool   [json-args]

# Configuration
mcp-cli-ent create-config [filename]  # Create example config
mcp-cli-ent version                   # Show version info

# Session management
mcp-cli-ent session list              # List active sessions
mcp-cli-ent session status    # Show session status
mcp-cli-ent session start     # Start persistent session
mcp-cli-ent session stop      # Stop session
mcp-cli-ent session restart   # Restart session
mcp-cli-ent session attach    # Attach to existing session
mcp-cli-ent session cleanup           # Clean up dead sessions

# Daemon management
mcp-cli-ent daemon start              # Start daemon (background)
mcp-cli-ent daemon start --foreground # Start daemon (foreground)
mcp-cli-ent daemon stop               # Stop daemon
mcp-cli-ent daemon status             # Show daemon status
mcp-cli-ent daemon restart            # Restart daemon
mcp-cli-ent daemon logs               # Show daemon logs
mcp-cli-ent daemon logs --tail 100    # Show last 100 log lines

浏览器自动化

持久浏览器自动化（Chrome DevTools、Playwright）会自动工作。只需调用工具：

mcp-cli-ent call-tool chrome-devtools navigate_page '{"url": "https://example.com"}'
mcp-cli-ent call-tool chrome-devtools take_screenshot

当您使用这些工具时，守护进程会自动启动。

从源代码构建

git clone https://github.com/EstebanForge/mcp-cli-ent.git
cd mcp-cli-ent
make build

要求： 转到1.21+

构建命令

make build          # Build unsigned local binary (bin/mcp-cli-ent)
make sign           # Sign local binary on macOS (optional)
make build-signed   # Build + sign local binary on macOS (optional)
make build-all      # Build for all platforms
make dev-setup      # Development setup
make test           # Run tests
make test-coverage  # Run tests with coverage
make fmt            # Format code (go fmt + optional goimports)
make vet            # Run go vet
make lint           # Lint code
make check          # Full flow: fmt + vet + lint + test + build (+check-config)
make ci             # CI alias for make check

安全与诚信建设

MCP CLI Ent通过GitHub Actions使用自动化、可复制的构建：

• CI/CD管道：所有通过GitHub Actions自动构建的版本
• 无手动构建：通过从不在本地构建来防止篡改
• 可复制建筑：每个构建都可追溯到源代码提交
• 自动化测试：每个版本都通过了全面的测试
• 密码验证：发布工件包括SHA256校验和

验证下载

# Verify checksum (provided in release notes)
sha256sum mcp-cli-ent-linux-amd64

信任，但要核实。 始终从GitHub官方版本下载并验证校验和。

许可证

麻省理工学院