
arcadeai-labs/mcpx
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Интерфейс командной строки для серверов MCP. Кёрл для MCP.
Обзор
Интерфейс командной строки для серверов MCP. Интернет обсуждает CLI и MCP, как конкурентов. Это не так. 1. (Claude Code, Cursor), которые предпочитают обшивку, чем поддержание постоянных MCP-соединений - лучше для управления токенами, прогрессивного обнаружения инструментов и совместного использования одного пула MCP-серверов на нескольких агентах на одной машине 2. которые нуждаются в программном доступе к инструментам MCP от TypeScript - удаленные, постоянные или изолированные агенты, которые не имеют оболочки 3. кому нужен быстрый способ обнаружения, отладки и тестирования своих серверов с терминала Установщики Curl / PowerShell загружают предварительно построенный двоичный файл — время выполнения не требуется. Метод установки булочки требует Бун. Бинарные опционы для всех платформ также доступны на странице релизов GitHub. mcpx автоматически определяет, являются ли stdout/stderr интерактивными и адаптируется: - TTY → цветной, отформатированный выход (таблицы, заголовки, значки). - Non-TTY / piped → JSON.
Обзор (машинный перевод)
Интерфейс командной строки для серверов MCP. ** кривая для MCP.**
Интернет обсуждает CLI и MCP, как конкурентов. Это не так.
Три аудитории:
- ** Кодирующие агенты** (Claude Code, Cursor), которые предпочитают обстреливать, а не поддерживать постоянные соединения MCP — лучше для управления токенами, прогрессивного обнаружения инструментов и совместного использования одного пула серверов MCP на нескольких агентах на одной машине
- Некодирующие агенты, которым необходим программный доступ к инструментам MCP из TypeScript — удаленные, постоянные или изолированные агенты, не имеющие оболочки
- ** Разработчики MCP**, которым нужен быстрый способ обнаружения, отладки и тестирования своих серверов с терминала
##Установка
Установщики Curl / PowerShell загружают предварительно построенный двоичный файл — время выполнения не требуется. Метод установки булочки требует Бун. Бинарные опционы для всех платформ также доступны на странице релизов GitHub.
Быстрый старт
Команды
| Командование | Описание
mcpx Перечислите все настроенные серверы и инструменты
| mcpx servers | Список настроенных серверов (имя, тип, деталь) |
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
mcpx
A command-line interface for MCP servers. curl for MCP.
The internet is debating CLI vs MCP like they’re competitors. They’re not.
Three audiences:
- Coding agents (Claude Code, Cursor) that prefer shelling out over maintaining persistent MCP connections — better for token management, progressive tool discovery, and sharing a single pool of MCP servers across multiple agents on one machine
- Non-coding agents that need programmatic access to MCP tools from TypeScript — remote, persistent, or isolated agents that don’t have a shell
- MCP developers who need a fast way to discover, debug, and test their servers from the terminal
Install
# Via bun (all platforms)
bun install -g @arcadeai/mcpx
# Via curl (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/arcadeai-labs/mcpx/main/install.sh | bash
# Via PowerShell (Windows)
irm https://raw.githubusercontent.com/arcadeai-labs/mcpx/main/install.ps1 | iex
The curl/PowerShell installers download a pre-built binary — no runtime needed. The bun install method requires Bun. Binaries for all platforms are also available on the GitHub Releases page.
Quick Start
# Add the GitHub MCP server
mcpx add github --url https://mcp.github.com
# List all servers and their tools
mcpx
# List with descriptions
mcpx -d
# Inspect a server
mcpx info github
# Inspect a specific tool
mcpx info github search_repositories
# Execute a tool (JSON args)
mcpx exec github search_repositories '{"query": "mcp server"}'
# Execute a tool with shell-style flags (anything after `--` is parsed against the tool's input schema)
mcpx exec github search_repositories -- --query "mcp server"
# Execute a tool without specifying the server (auto-resolved)
mcpx exec search_repositories '{"query": "mcp server"}'
mcpx exec search_repositories -- --query "mcp server"
# Search tools — combines keyword and semantic matching
mcpx search "post a ticket to linear"
# Search with only keyword/glob matching (fast, no embeddings)
mcpx search -k "*file*"
# Search with only semantic matching
mcpx search -q "manage pull requests"
# Limit the number of results (default: 10)
mcpx search -n 5 "manage pull requests"
Commands
| Command | Description |
|---|---|
mcpx |
List all configured servers and tools |
mcpx servers |
List configured servers (name, type, detail) |
mcpx info |
Server overview (version, capabilities, tools, counts, session id) |
mcpx info |
Show tool schema |
Установка
npx -y @modelcontextprotocol/server-filesystem .Конфигурация
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
"env": { "API_KEY": "${API_KEY}" },
"allowedTools": ["read_file", "list_directory"],
"disabledTools": ["delete_file"]
},
"github": {
"url": "https://mcp.github.com"
},
"internal-api": {
"url": "https://mcp.internal.example.com",
"headers": { "Authorization": "Bearer ${TOKEN}" }
},
"legacy-sse": {
"url": "https://legacy.example.com/sse",
"transport": "sse"
},
"modern-mcp": {
"url": "https://mcp.example.com",
"mcp": "v2"
},
"slack": {
"url": "https://mcp.slack.com/mcp",
"transport": "streamable-http",
"oauth": {
"clientId": "${SLACK_CLIENT_ID}",
"clientSecret": "${SLACK_CLIENT_SECRET}",
"callbackPort": 3118
}
}
}
}