Modern Cli MCP

🚀 現代CLI MCP服務器

現代CLI MCP服務器向AI/LLM代理公開了107種現代CLI工具。它提供了對文件系統、Git託管平臺、容器、Kubernetes和數據轉換工具的結構化JSON - RPC訪問，所有輸出均為JSON格式，便於AI處理。

🚀 快速開始

Claude桌面版 / Claude代碼版

將以下內容添加到您的MCP配置中：

選項1：Nix（推薦）

{
  "mcpServers": {
    "modern-cli": {
      "command": "nix",
      "args": ["run", "github:NacoSolutions/modern-cli-mcp", "--"]
    }
  }
}

選項2：Docker

{
  "mcpServers": {
    "modern-cli": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/nacosolutions/modern-cli-mcp"]
    }
  }
}

選項3：二進制文件

{
  "mcpServers": {
    "modern-cli": {
      "command": "/path/to/modern-cli-mcp"
    }
  }
}

✨ 主要特性

• 15個組中的107種工具：涵蓋文件系統、搜索、Git（GitHub/GitLab）、容器、Kubernetes和數據處理等方面。
• AI優化輸出：默認輸出JSON格式，便於結構化解析。
• 訪問控制：使用.agentignore文件控制AI代理可以訪問的文件。
• 零配置：Nix捆綁了所有依賴項，無需手動安裝工具。

📦 安裝指南

使用Flakes的Nix（推薦）

在Determinate Nix中，Flakes默認啟用。對於標準Nix，可使用--experimental-features 'nix-command flakes'啟用，或添加到~/.config/nix/nix.conf中：

experimental-features = nix-command flakes

直接運行（無需安裝）：

nix run github:NacoSolutions/modern-cli-mcp

安裝到配置文件：

nix profile install github:NacoSolutions/modern-cli-mcp

添加到flake.nix：

{
  inputs.modern-cli-mcp.url = "github:NacoSolutions/modern-cli-mcp";

  # 在輸出中使用
  outputs = { self, nixpkgs, modern-cli-mcp }: {
    # 添加到包、開發環境等
  };
}

使用FlakeHub的Nix

FlakeHub提供了帶有語義版本控制的版本化flake引用。

通過CLI添加到flake.nix：

fh add NacoSolutions/modern-cli-mcp

或手動添加：

{
  inputs.modern-cli-mcp.url = "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/*.tar.gz";
}

運行特定版本：

nix run "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/0.2.tar.gz"

不使用Flakes的Nix（經典方式）

對於未啟用flakes的Nix安裝，該倉庫通過flake - compat包含了一個default.nix：

從tarball構建：

nix-build https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default
./result/bin/modern-cli-mcp

或克隆並在本地構建：

git clone https://github.com/NacoSolutions/modern-cli-mcp
cd modern-cli-mcp
nix-build
./result/bin/modern-cli-mcp

安裝到配置文件：

nix-env -if https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default

Docker

docker pull ghcr.io/nacosolutions/modern-cli-mcp
docker run --rm -i ghcr.io/nacosolutions/modern-cli-mcp

從源代碼（Cargo）安裝

需要將CLI工具分別安裝到PATH中：

cargo install --git https://github.com/NacoSolutions/modern-cli-mcp

💻 使用示例

可用工具（70 +）

文件系統

搜索

Git託管平臺

容器

Kubernetes

數據轉換

網絡

系統

差異/Git

實用工具

🔧 技術細節

架構

src/
├── main.rs           # 入口點，MCP服務器設置
└── tools/
    ├── mod.rs        # 工具註冊和路由
    └── executor.rs   # 工具執行邏輯

服務器使用結構化的JSON輸入/輸出包裝CLI工具。每個工具：

1. 通過JSON Schema驗證參數
2. 構建適當的命令
3. 執行並捕獲輸出
4. 返回結構化結果

配置

Nix包捆綁了所有CLI工具。通過cargo運行時，確保工具在PATH中。

環境變量

• RUST_LOG - 日誌級別（默認：info）

.agentignore

使用.agentignore文件控制AI代理可以訪問的文件。使用gitignore語法，但獨立操作 - 工具僅遵循.agentignore，而不是.gitignore。

模式來源（按優先級排序）：

1. ~/.config/agent/ignore - 所有項目的全局模式
2. .agentignore - 每個目錄的模式（從工作目錄向上查找）

示例.agentignore：

# 秘密和憑證
*.secret
.env*
secrets/
credentials.json

# 大型生成文件
node_modules/
target/
*.min.js

# 敏感數據
*.pem
*.key

行為：

• 被阻止的路徑返回錯誤：Path is blocked by .agentignore: /path/to/file
• 搜索工具（fd、rg、ast - grep）自動應用忽略模式
• 子目錄中的模式擴展（而不是替換）父目錄的模式

📄 許可證

本項目採用MIT許可證。