mcpli
一个命令可以将任何MCP服务器转换为CLI工具。
mcpli add knuspr https://mcp.knuspr.de/mcp/ \
--header 'rhl-email: ${ROHLIK_USERNAME}' \
--header 'rhl-pass: ${ROHLIK_PASSWORD}'
mcpli knuspr batch_search_products '{"queries": [{"keyword": "milk"}]}'特性
- ⚡ 瞬间 —
mcpli add连接、获取工具,您就可以开始了。无需手动设置 - 🔍 发现的 --shell中服务器和工具的选项卡完成
- 📖 自我记录 —
--help显示每个级别的完整工具描述 - 🔧 熟悉的 --与您已经使用的任何CLI(git、kubectl等)一样工作
- 🤖 代理商友好 --AI代理可以通过一个命令添加和使用MCP服务器
快速开始
# 1. Add a server (fetches and caches all tools)
mcpli add myserver https://example.com/mcp/
# 2. Explore available tools
mcpli myserver --help
# 3. Invoke a tool
mcpli myserver search '{"query": "hello"}'安装
自制(macOS/Linux)
brew install juanibiapina/taps/mcpli去
go install github.com/juanibiapina/mcpli@latest从源代码构建
git clone https://github.com/juanibiapina/mcpli
cd mcpli
go build -o mcpli ./cmd/mcpli发现工具
每个服务器和工具都是一个带有内置帮助的本机子命令:
# See all configured servers
mcpli --help
# See all tools on a server
mcpli myserver --help
# See a tool's full description and usage
mcpli myserver search_products --help输出示例 mcpli myserver --help:
Usage:
mcpli myserver [command]
Available Commands:
get_cart View everything currently in the shopping cart...
search_products Search products by keyword, filters, or recomm...
add_items_to_cart Put products into the cart for purchase...
Use "mcpli myserver [command] --help" for more information about a command.壳牌完井
为服务器和工具启用选项卡完成:
# Bash
echo 'source > ~/.bashrc
# Zsh
echo 'source > ~/.zshrc
# Fish
mcpli completion fish | source设置后,选项卡完成对所有内容都有效:
mcpli # Complete server names
mcpli myserver # Complete tool names命令
添加服务器
mcpli add [--header "key: value"]...标头可以包含环境变量引用,使用 ${VAR_NAME} 语法:
mcpli add knuspr https://mcp.knuspr.de/mcp/ \
--header 'rhl-email: ${ROHLIK_USERNAME}' \
--header 'rhl-pass: ${ROHLIK_PASSWORD}'这将连接到服务器,获取所有可用工具,并在本地缓存它们。
列出服务器
mcpli list列出服务器的工具
mcpli list 调用工具
mcpli [json-arguments]示例:
# Tool with no arguments
mcpli myserver get_cart
# Tool with arguments
mcpli myserver search_products '{"keyword": "milk"}'OAuth身份验证
当服务器需要OAuth时,mcpli会自动检测401响应并启动授权流程:
mcpli add glean https://contentful-be.glean.com/mcp/default
# → Detects 401, opens browser for OAuth login
# → Stores tokens, completes server setup身份验证后,在调用工具时透明地使用令牌。过期的令牌会自动刷新。OAuth凭据按照XDG约定存储($XDG_STATE_HOME/mcpli/auth.json).
如果自动令牌刷新失败,请使用以下方式重新进行身份验证:
mcpli update 更新服务器
刷新缓存的工具定义:
mcpli update 删除服务器
mcpli remove 配置
配置存储在 ~/.config/mcpli/config.json (遵循XDG惯例)。
配置文件包含服务器URL、标头(带有未展开的env-var引用)和缓存的工具定义。
许可证
麻省理工学院
