mcp-cli 完整教學

1curl -fsSL https://raw.githubusercontent.com/doggy8088/mcp-cli/main/install.sh | bash

1# 需要先安裝 Rust toolchain
2cargo install --git https://github.com/doggy8088/mcp-cli

1npm install -g @willh/mcp-cli

1mcp-cli --version
2# 輸出: mcp-cli v0.1.1

 1{
 2  "mcpServers": {
 3    "filesystem": {
 4      "command": "npx",
 5      "args": [
 6        "-y",
 7        "@modelcontextprotocol/server-filesystem",
 8        "."
 9      ]
10    },
11    "deepwiki": {
12      "url": "https://mcp.deepwiki.com/mcp"
13    }
14  }
15}

 1{
 2  "mcpServers": {
 3    "github": {
 4      "command": "npx",
 5      "args": ["-y", "@modelcontextprotocol/server-github"],
 6      "env": {
 7        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
 8      }
 9    }
10  }
11}

 1{
 2  "mcpServers": {
 3    "filesystem": {
 4      "command": "npx",
 5      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
 6      "allowedTools": ["read_*", "list_*"],
 7      "disabledTools": ["delete_*"]
 8    }
 9  }
10}

1mcp-cli [options]                              列出所有 servers 與 tools
2mcp-cli [options] info <server>                顯示 server 詳情
3mcp-cli [options] info <server> <tool>         顯示 tool schema
4mcp-cli [options] info <server>/<tool>         同上 (斜線分隔格式)
5mcp-cli [options] grep <pattern>               用 glob pattern 搜尋 tools
6mcp-cli [options] call <server> <tool>         呼叫 tool (無 args 時從 stdin 讀取)
7mcp-cli [options] call <server> <tool> <json>  使用 JSON arguments 呼叫 tool

 1# 步驟 1：列出所有 servers 與 tools
 2$ mcp-cli
 3github
 4  • search_repositories
 5  • get_file_contents
 6  • create_or_update_file
 7filesystem
 8  • read_file
 9  • write_file
10  • list_directory
11
12# 步驟 2：加上 -d 顯示每個 tool 的描述
13$ mcp-cli -d
14github
15  • search_repositories - Search for GitHub repositories
16  • get_file_contents - Get contents of a file or directory
17filesystem
18  • read_file - Read the contents of a file
19  • write_file - Write content to a file
20
21# 步驟 3：用 glob pattern 搜尋特定 tool
22$ mcp-cli grep "*file*"
23github/get_file_contents
24github/create_or_update_file
25filesystem/read_file
26filesystem/write_file
27
28# 步驟 4：查看特定 tool 的完整 schema
29$ mcp-cli info filesystem read_file
30Tool: read_file
31Server: filesystem
32
33Description:
34  Read the contents of a file
35
36Input Schema:
37  {
38    "type": "object",
39    "properties": {
40      "path": { "type": "string", "description": "Path to the file" }
41    },
42    "required": ["path"]
43  }

 1# 基本呼叫：讀取檔案
 2$ mcp-cli call filesystem read_file '{"path": "./README.md"}'
 3
 4# 搭配 jq 擷取特定欄位
 5$ mcp-cli call github search_repositories '{"query": "mcp server", "per_page": 5}' \
 6  | jq -r '.content[0].text | fromjson | .items[].html_url'
 7
 8# 從 stdin 讀取 JSON（避免 shell escaping 問題）
 9$ echo '{"path": "./README.md"}' | mcp-cli call filesystem read_file
10
11# 使用 heredoc 處理含特殊字元的 JSON
12$ mcp-cli call server tool <<EOF
13{"content": "Text with 'single quotes' and \"double quotes\""}
14EOF
15
16# 進階串接：搜尋檔案後逐一讀取內容
17$ mcp-cli call filesystem search_files '{"path": ".", "pattern": "*.md"}' \
18  | jq -r '.content[0].text | split("\n")[]' \
19  | while read file; do
20      echo "=== $file ==="
21      mcp-cli call filesystem read_file "{\"path\": \"$file\"}" \
22        | jq -r '.content[0].text'
23    done
24
25# 條件式執行：先確認檔案存在再讀取
26$ mcp-cli call filesystem list_directory '{"path": "."}' \
27  | jq -e '.content[0].text | contains("README.md")' \
28  && mcp-cli call filesystem read_file '{"path": "./README.md"}'
29
30# 錯誤處理：在腳本中安全地呼叫 tool
31$ if result=$(mcp-cli call filesystem read_file '{"path": "./config.json"}' 2>/dev/null); then
32    echo "$result" | jq '.content[0].text | fromjson'
33  else
34    echo "File not found, using defaults"
35  fi

1[dependencies]
2mcp-cli = { git = "https://github.com/doggy8088/mcp-cli" }

 1use mcp_cli::McpClient;
 2
 3#[tokio::main]
 4async fn main() -> Result<(), mcp_cli::CliError> {
 5    // 載入 mcp_servers.json 設定
 6    let client = McpClient::load(None)?;
 7
 8    // 列出所有 server 名稱
 9    for server in client.server_names() {
10        // 列出每個 server 的 tools
11        let tools = client.list_tools(&server).await?;
12        println!("{}: {} tools", server, tools.len());
13
14        // 顯示每個 tool 的名稱
15        for tool in &tools {
16            println!("  - {}", tool.name);
17        }
18    }
19
20    // 呼叫特定 tool
21    let result = client
22        .call_tool(
23            "filesystem",
24            "read_file",
25            serde_json::json!({ "path": "./README.md" }),
26        )
27        .await?;
28
29    // 格式化並輸出結果
30    println!("{}", mcp_cli::output::format_tool_result(&result));
31    Ok(())
32}

 1use mcp_cli::prelude::*;
 2
 3#[tokio::main]
 4async fn main() -> Result<(), CliError> {
 5    // 手動載入設定
 6    let config = mcp_cli::config::load_config(Some("./my_config.json"))?;
 7
 8    // 取得特定 server 設定
 9    let server_config = mcp_cli::config::get_server_config(&config, "filesystem")?;
10
11    // 手動建立連線
12    let connection = mcp_cli::client::get_connection("filesystem", &server_config).await?;
13
14    // 列出 tools
15    let tools = connection.list_tools().await?;
16    println!("Available tools: {:?}", tools);
17
18    // 呼叫 tool
19    let result = connection
20        .call_tool("read_file", serde_json::json!({"path": "."}))
21        .await?;
22
23    // 關閉連線
24    connection.close().await?;
25    Ok(())
26}

 1src/
 2├── main.rs          # CLI 進入點、指令解析、daemon 模式分支
 3├── lib.rs           # Library 公開介面 (re-exports + prelude)
 4├── api.rs           # McpClient 高階 API (library 使用者的主要介面)
 5├── client.rs        # StdioClient + HttpClient + McpConnection 統一介面
 6├── config.rs        # 設定檔載入、env 替換、tool filtering、hash 計算
 7├── daemon.rs        # 連線池 daemon 實作 (Unix socket listener)
 8├── daemon_client.rs # Daemon IPC 客戶端 + orphan 清理
 9├── errors.rs        # CliError 結構化錯誤系統
10├── output.rs        # ServerInfo / ToolInfo 格式化輸出
11└── commands/
12    ├── mod.rs       # 指令模組匯出
13    ├── list.rs      # `mcp-cli` (無子指令) — 列出所有 servers
14    ├── info.rs      # `mcp-cli info` — 查看 server/tool 詳情
15    ├── grep.rs      # `mcp-cli grep` — 搜尋 tools
16    └── call.rs      # `mcp-cli call` — 呼叫 tool

 1// 實際的 matching 邏輯 (簡化)
 2fn matches_pattern(name: &str, pattern: &str) -> bool {
 3    // 將 glob pattern 轉換為 regex
 4    // "*" -> ".*", "?" -> "."
 5    // Case-insensitive matching
 6}
 7
 8fn is_tool_allowed(tool_name: &str, config: &ServerConfig) -> bool {
 9    // 1. 先檢查 disabledTools -> 命中則 return false
10    // 2. 再檢查 allowedTools -> 有設定時必須命中才 return true
11    // 3. 兩者都未設定 -> return true (全部允許)
12}

1[profile.release]
2opt-level = 3      # 最高最佳化等級
3lto = true          # Link-Time Optimization (連結期最佳化)
4codegen-units = 1   # 單一編譯單元 (更慢的編譯，更快的 binary)
5panic = "abort"     # Panic 時直接 abort (減少 binary 大小)
6strip = true        # 移除 debug symbols

1Error [AMBIGUOUS_COMMAND]: Ambiguous command: did you mean to call a tool or view info?
2  Details: Received: mcp-cli filesystem read_file
3  Suggestion: Use 'mcp-cli call filesystem read_file' to execute,
4              or 'mcp-cli info filesystem read_file' to view schema